# Batch 2 — Controls, Components, and Component Models API Reference

This page documents every explicitly source-declared public type in the second API Reference batch: stable beginner controls, advanced product controls, component models, event payloads, snapshots, and DropDownMenu models. It is source-derived from the current manifests and evidence paths.

## Batch status

| Item | Value |
|---|---:|
| Public types in batch | `172` |
| Stable types | `49` |
| Advanced types | `114` |
| Preview types | `9` |
| V1-approved types | `49` |
| Verification | Source-documented only; no Windows/MSBuild execution was performed by this documentation pass. |

## Namespace split

| Namespace | Public type records |
|---|---:|
| `Nexamas.UI.Components` | `117` |
| `Nexamas.UI.Components.DropDownMenu` | `5` |
| `Nexamas.UI.Controls` | `50` |

## Consumer boundary

Stable `Nexamas.UI.Controls` records are the beginner control surface when paired with the Application/window-owned route. `Nexamas.UI.Components` and `Nexamas.UI.Components.DropDownMenu` records are documented because they are public, but most are `Advanced` or `Preview`; do not present them as the default beginner path unless a recipe or Application factory explicitly does so.

## Related recipe groups

- [Buttons recipes](../../recipes/buttons.md)
- [Inputs recipes](../../recipes/inputs.md)
- [Feedback recipes](../../recipes/feedback.md)
- [Surfaces recipes](../../recipes/surfaces.md)
- [Navigation recipes](../../recipes/navigation.md)
- [DataGrid recipes](../../recipes/datagrid.md)
- [Product controls recipes](../../recipes/product-controls.md)

## Type quick index

### `Nexamas.UI.Components`
[`MASAgendaView`](#masagendaview) · [`MASAppLayout`](#masapplayout) · [`MASAppLayoutSnapshot`](#masapplayoutsnapshot) · [`MASAppliedFilterRemoveRequestedEventArgs`](#masappliedfilterremoverequestedeventargs)
[`MASAppliedFiltersBar`](#masappliedfiltersbar) · [`MASAvatar`](#masavatar) · [`MASAvatarGroup`](#masavatargroup) · [`MASBreadcrumb`](#masbreadcrumb)
[`MASCalendarView`](#mascalendarview) · [`MASChart`](#maschart) · [`MASChartLegend`](#maschartlegend) · [`MASCheckBox`](#mascheckbox)
[`MASColorPicker`](#mascolorpicker) · [`MASColorPickerColorChangedEventArgs`](#mascolorpickercolorchangedeventargs) · [`MASComboBox`](#mascombobox) · [`MASContentCarousel`](#mascontentcarousel)
[`MASDashboardGrid`](#masdashboardgrid) · [`MASDashboardGridLayoutSnapshot`](#masdashboardgridlayoutsnapshot) · [`MASDashboardGridWidgetSnapshot`](#masdashboardgridwidgetsnapshot) · [`MASDataForm`](#masdataform)
[`MASDataGrid`](#masdatagrid) · [`MASDataGridCellAddress`](#masdatagridcelladdress) · [`MASDataGridCellValueChangedEventArgs`](#masdatagridcellvaluechangedeventargs) · [`MASDataGridColumn`](#masdatagridcolumn)
[`MASDataGridRow`](#masdatagridrow) · [`MASDataView`](#masdataview) · [`MASDatePicker`](#masdatepicker) · [`MASDateRangePicker`](#masdaterangepicker)
[`MASFileDropZone`](#masfiledropzone) · [`MASFileExplorerItem`](#masfileexploreritem) · [`MASFileExplorerItemActivatedEventArgs`](#masfileexploreritemactivatedeventargs) · [`MASFileExplorerView`](#masfileexplorerview)
[`MASFilePickerControl`](#masfilepickercontrol) · [`MASFilePickerResultEventArgs`](#masfilepickerresulteventargs) · [`MASFilterBuilder`](#masfilterbuilder) · [`MASFilterRule`](#masfilterrule)
[`MASFormBuilder`](#masformbuilder) · [`MASImageViewer`](#masimageviewer) · [`MASInputBoxSkiaBase`](#masinputboxskiabase) · [`MASKanbanBoard`](#maskanbanboard)
[`MASKanbanBoardSnapshot`](#maskanbanboardsnapshot) · [`MASKanbanCardSnapshot`](#maskanbancardsnapshot) · [`MASKanbanColumnSnapshot`](#maskanbancolumnsnapshot) · [`MASListBox`](#maslistbox)
[`MASListView`](#maslistview) · [`MASListViewColumn`](#maslistviewcolumn) · [`MASListViewColumnClickEventArgs`](#maslistviewcolumnclickeventargs) · [`MASListViewEmptySpaceContextMenuRequestedEventArgs`](#maslistviewemptyspacecontextmenurequestedeventargs)
[`MASListViewInlineRenameCommittedEventArgs`](#maslistviewinlinerenamecommittedeventargs) · [`MASListViewItem`](#maslistviewitem) · [`MASListViewItemContextMenuRequestedEventArgs`](#maslistviewitemcontextmenurequestedeventargs) · [`MASMasterDetailItemSnapshot`](#masmasterdetailitemsnapshot)
[`MASMasterDetailView`](#masmasterdetailview) · [`MASMasterDetailViewSnapshot`](#masmasterdetailviewsnapshot) · [`MASMenuBar`](#masmenubar) · [`MASMetricCard`](#masmetriccard)
[`MASMultilineTextBox`](#masmultilinetextbox) · [`MASNavigationRail`](#masnavigationrail) · [`MASNumericTextBox`](#masnumerictextbox) · [`MASPagination`](#maspagination)
[`MASPasswordTextBox`](#maspasswordtextbox) · [`MASPathTextBox`](#maspathtextbox) · [`MASPivotTable`](#maspivottable) · [`MASPropertyGrid`](#maspropertygrid)
[`MASRadioButton`](#masradiobutton) · [`MASRating`](#masrating) · [`MASSearchTextBox`](#massearchtextbox) · [`MASSegmentEntry`](#massegmententry)
[`MASSelectorItemEntry`](#masselectoritementry) · [`MASSlider`](#masslider) · [`MASSplitButton`](#massplitbutton) · [`MASSplitView`](#massplitview)
[`MASSplitViewLayoutSnapshot`](#massplitviewlayoutsnapshot) · [`MASTagInput`](#mastaginput) · [`MASTextBox`](#mastextbox) · [`MASTileBox`](#mastilebox)
[`MASTileBox.MASTileClickedEventArgs`](#mastileboxmastileclickedeventargs) · [`MASTileBox.MASTileItem`](#mastileboxmastileitem) · [`MASTimePicker`](#mastimepicker) · [`MASTimeline`](#mastimeline)
[`MASToggleSwitch`](#mastoggleswitch) · [`MASToolbar`](#mastoolbar) · [`MASToolbarButtonClickedEventArgs`](#mastoolbarbuttonclickedeventargs) · [`MASToolbarSeparator`](#mastoolbarseparator)
[`MASToolbarSpacer`](#mastoolbarspacer) · [`MASTopBarCommandEventArgs`](#mastopbarcommandeventargs) · [`MASTopBarComponent`](#mastopbarcomponent) · [`MASTopBarWindowCommandEventArgs`](#mastopbarwindowcommandeventargs)
[`MASTransferList`](#mastransferlist) · [`MASTreeGrid`](#mastreegrid) · [`MASTreeNode`](#mastreenode) · [`MASTreeNodeCollection`](#mastreenodecollection)
[`MASTreeView`](#mastreeview) · [`MASAgendaViewMode`](#masagendaviewmode) · [`MASButtonPersonality`](#masbuttonpersonality) · [`MASColorPickerSlot`](#mascolorpickerslot)
[`MASDataFormFieldKind`](#masdataformfieldkind) · [`MASDataFormFieldState`](#masdataformfieldstate) · [`MASDataGridSelectionMode`](#masdatagridselectionmode) · [`MASDataGridSortDirection`](#masdatagridsortdirection)
[`MASDataGridSummaryFooterMode`](#masdatagridsummaryfootermode) · [`MASFileExplorerItemKind`](#masfileexploreritemkind) · [`MASFileExplorerLocationKind`](#masfileexplorerlocationkind) · [`MASFilterOperator`](#masfilteroperator)
[`MASImageExportFormat`](#masimageexportformat) · [`MASImageViewerChromeMode`](#masimageviewerchromemode) · [`MASListViewChromeMode`](#maslistviewchromemode) · [`MASListViewColumnTextAlign`](#maslistviewcolumntextalign)
[`MASListViewItemKind`](#maslistviewitemkind) · [`MASListViewMode`](#maslistviewmode) · [`MASListViewSortDirection`](#maslistviewsortdirection) · [`MASProgressBarState`](#masprogressbarstate)
[`MASSelectorItemGlyphKind`](#masselectoritemglyphkind) · [`MASTimelineItemState`](#mastimelineitemstate) · [`MASToolbarItemAlignment`](#mastoolbaritemalignment) · [`MASToolbarItemSizing`](#mastoolbaritemsizing)
[`MASTopBarWindowCommand`](#mastopbarwindowcommand)

### `Nexamas.UI.Components.DropDownMenu`
[`MASDropDownMenuBuilder`](#masdropdownmenubuilder) · [`MASDropDownMenuModel`](#masdropdownmenumodel) · [`MASDropDownMenuNode`](#masdropdownmenunode) · [`MASDropDownMenuItemIntent`](#masdropdownmenuitemintent)
[`MASDropDownMenuNodeKind`](#masdropdownmenunodekind)

### `Nexamas.UI.Controls`
[`MASAccordion`](#masaccordion) · [`MASBadge`](#masbadge) · [`MASButton`](#masbutton) · [`MASCallout`](#mascallout)
[`MASCard`](#mascard) · [`MASCommandPalette`](#mascommandpalette) · [`MASControlBase`](#mascontrolbase) · [`MASDrawer`](#masdrawer)
[`MASEmptyState`](#masemptystate) · [`MASExpander`](#masexpander) · [`MASFormValidationSummary`](#masformvalidationsummary) · [`MASGroupBox`](#masgroupbox)
[`MASLabel`](#maslabel) · [`MASLoadingSkeleton`](#masloadingskeleton) · [`MASNotificationPanel`](#masnotificationpanel) · [`MASOperationProgressBox`](#masoperationprogressbox)
[`MASPopover`](#maspopover) · [`MASProgressBar`](#masprogressbar) · [`MASSegmentedControl`](#massegmentedcontrol) · [`MASSegmentedControlSelectionChangedEventArgs`](#massegmentedcontrolselectionchangedeventargs)
[`MASSelectorItemControl`](#masselectoritemcontrol) · [`MASSidePanel`](#massidepanel) · [`MASStatusBanner`](#masstatusbanner) · [`MASStepper`](#masstepper)
[`MASTabControl`](#mastabcontrol) · [`MASTabItem`](#mastabitem) · [`MASTitle`](#mastitle) · [`MASToastEventArgs`](#mastoasteventargs)
[`MASToastOptions`](#mastoastoptions) · [`MASValidationMessage`](#masvalidationmessage) · [`MASWinControlBase`](#maswincontrolbase) · [`MASWizard`](#maswizard)
[`MASButtonIconPlacement`](#masbuttoniconplacement) · [`MASCalloutPlacement`](#mascalloutplacement) · [`MASDrawerSide`](#masdrawerside) · [`MASFormValidationSummaryInteractionMode`](#masformvalidationsummaryinteractionmode)
[`MASGroupBoxBorderRecipe`](#masgroupboxborderrecipe) · [`MASGroupBoxBorderStrength`](#masgroupboxborderstrength) · [`MASGroupBoxSurfaceSource`](#masgroupboxsurfacesource) · [`MASGroupBoxTitlePlateStrength`](#masgroupboxtitleplatestrength)
[`MASHorizontalAlignment`](#mashorizontalalignment) · [`MASLabelTextRole`](#maslabeltextrole) · [`MASLabelVariant`](#maslabelvariant) · [`MASProgressBarFrameMode`](#masprogressbarframemode)
[`MASProgressBarLabelPlacement`](#masprogressbarlabelplacement) · [`MASStepperOrientation`](#masstepperorientation) · [`MASStepperStepState`](#masstepperstepstate) · [`MASToastPlacement`](#mastoastplacement)
[`MASToastTone`](#mastoasttone) · [`MASVerticalAlignment`](#masverticalalignment)

## `Nexamas.UI.Components`

### `MASAgendaView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/AgendaView/MASAgendaView.DataSource.vb:15`<br>`Component/Data/AgendaView/MASAgendaView.EventEditPolicy.vb:43`<br>`Component/Data/AgendaView/MASAgendaView.Events.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Geometry.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Governance.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Interaction.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.ItemModel.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Layout.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Motion.vb:14`<br>`Component/Data/AgendaView/MASAgendaView.PointerState.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.RangeRendering.vb:18`<br>`Component/Data/AgendaView/MASAgendaView.Rendering.Body.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Rendering.Footer.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Rendering.Header.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Rendering.Rows.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.Rendering.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.TimeLayout.vb:15`<br>`Component/Data/AgendaView/MASAgendaView.ViewState.vb:22`<br>`Component/Data/AgendaView/MASAgendaView.VisibleRangeWindow.vb:136`<br>`Component/Data/AgendaView/MASAgendaView.vb:28` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Agenda View component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `AgendaChanged` | Event | `Public Event AgendaChanged As EventHandler` |
| `SelectedEventChanged` | Event | `Public Event SelectedEventChanged As EventHandler` |
| `AddEvent` | Function | `Public Function AddEvent(eventKey As String, title As String, startTime As Date, endTime As Date, Optional detail As String = Nothing) As MASAgendaView` |
| `ClearEvents` | Function | `Public Function ClearEvents() As MASAgendaView` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional day As System.Nullable(Of Date) = Nothing) As MASAgendaView` |
| `GetEventKeys` | Function | `Public Function GetEventKeys() As IReadOnlyList(Of String)` |
| `MoveNextDay` | Function | `Public Function MoveNextDay() As MASAgendaView` |
| `MoveNextRange` | Function | `Public Function MoveNextRange() As MASAgendaView` |
| `MovePreviousDay` | Function | `Public Function MovePreviousDay() As MASAgendaView` |
| `MovePreviousRange` | Function | `Public Function MovePreviousRange() As MASAgendaView` |
| `MoveToday` | Function | `Public Function MoveToday() As MASAgendaView` |
| `SelectEvent` | Function | `Public Function SelectEvent(eventKey As String) As Boolean` |
| `WithDate` | Function | `Public Function WithDate(value As Date) As MASAgendaView` |
| `WithHours` | Function | `Public Function WithHours(startHour As Integer, endHour As Integer) As MASAgendaView` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASAgendaView` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASAgendaView` |
| `WithViewMode` | Function | `Public Function WithViewMode(value As MASAgendaViewMode) As MASAgendaView` |
| `Day` | Property | `Public Property Day As Date` |
| `EndHour` | Property | `Public Property EndHour As Integer` |
| `EventCount` | Property | `Public ReadOnly Property EventCount As Integer` |
| `SelectedEventKey` | Property | `Public ReadOnly Property SelectedEventKey As String` |
| `StartHour` | Property | `Public Property StartHour As Integer` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |
| `ViewMode` | Property | `Public Property ViewMode As MASAgendaViewMode` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASAppLayout`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Container/AppLayout/MASAppLayout.HostAdoption.vb:9`<br>`Component/Container/AppLayout/MASAppLayout.HostAdoptionSample.vb:9`<br>`Component/Container/AppLayout/MASAppLayout.Hosting.vb:11`<br>`Component/Container/AppLayout/MASAppLayout.Persistence.vb:56`<br>`Component/Container/AppLayout/MASAppLayout.RoutingBoundary.vb:6`<br>`Component/Container/AppLayout/MASAppLayout.vb:25` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the advanced App Layout component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `CreateLayoutSnapshot` | Function | `Public Function CreateLayoutSnapshot() As MASAppLayoutSnapshot` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASAppLayout` |
| `ResetLayoutSlots` | Function | `Public Function ResetLayoutSlots() As MASAppLayout` |
| `RestoreLayoutSnapshot` | Function | `Public Function RestoreLayoutSnapshot(snapshot As MASAppLayoutSnapshot) As Boolean` |
| `SetContent` | Function | `Public Function SetContent(title As String, text As String) As MASAppLayout` |
| `SetDetails` | Function | `Public Function SetDetails(title As String, text As String) As MASAppLayout` |
| `SetNavigation` | Function | `Public Function SetNavigation(title As String, text As String) As MASAppLayout` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASAppLayout` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASAppLayout` |
| `ContentText` | Property | `Public Property ContentText As String` |
| `ContentTitle` | Property | `Public Property ContentTitle As String` |
| `DetailText` | Property | `Public Property DetailText As String` |
| `DetailTitle` | Property | `Public Property DetailTitle As String` |
| `LayoutModeText` | Property | `Public ReadOnly Property LayoutModeText As String` |
| `NavigationText` | Property | `Public Property NavigationText As String` |
| `NavigationTitle` | Property | `Public Property NavigationTitle As String` |
| `ShowDetails` | Property | `Public Property ShowDetails As Boolean` |
| `ShowNavigation` | Property | `Public Property ShowNavigation As Boolean` |
| `ShowStatusBar` | Property | `Public Property ShowStatusBar As Boolean` |
| `StatusText` | Property | `Public Property StatusText As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASAppLayoutSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Container/AppLayout/MASAppLayout.Persistence.vb:15` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Represents a captured state snapshot for the App Layout Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(version As Integer, title As String, navigationTitle As String, navigationText As String, contentTitle As String, contentText As String, detailTitle As String, detailText As String, statusText As String, showNavigation As Boolean, showDetails As Boolean, showStatusBar As Boolean)` |
| `ContentText` | Property | `Public ReadOnly Property ContentText As String` |
| `ContentTitle` | Property | `Public ReadOnly Property ContentTitle As String` |
| `DetailText` | Property | `Public ReadOnly Property DetailText As String` |
| `DetailTitle` | Property | `Public ReadOnly Property DetailTitle As String` |
| `NavigationText` | Property | `Public ReadOnly Property NavigationText As String` |
| `NavigationTitle` | Property | `Public ReadOnly Property NavigationTitle As String` |
| `ShowDetails` | Property | `Public ReadOnly Property ShowDetails As Boolean` |
| `ShowNavigation` | Property | `Public ReadOnly Property ShowNavigation As Boolean` |
| `ShowStatusBar` | Property | `Public ReadOnly Property ShowStatusBar As Boolean` |
| `StatusText` | Property | `Public ReadOnly Property StatusText As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |
| `Version` | Property | `Public ReadOnly Property Version As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASAppliedFilterRemoveRequestedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/AppliedFiltersBar/MASAppliedFiltersBar.vb:23` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Carries typed event data for Applied Filter Remove Requested Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `DisplayText` | Property | `Public ReadOnly Property DisplayText As String` |
| `Index` | Property | `Public ReadOnly Property Index As Integer` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASAppliedFiltersBar`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/AppliedFiltersBar/MASAppliedFiltersBar.vb:43` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Applied Filters Bar component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `AppliedFiltersChanged` | Event | `Public Event AppliedFiltersChanged As EventHandler` |
| `FilterRemoveRequested` | Event | `Public Event FilterRemoveRequested As EventHandler(Of MASAppliedFilterRemoveRequestedEventArgs)` |
| `AddFilter` | Function | `Public Function AddFilter(fieldLabel As String, operatorText As String, valueText As String) As MASAppliedFiltersBar` |
| `ClearFilters` | Function | `Public Function ClearFilters() As MASAppliedFiltersBar` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional savedViewName As String = Nothing) As MASAppliedFiltersBar` |
| `GetFilterDisplayText` | Function | `Public Function GetFilterDisplayText(index As Integer) As String` |
| `GetFilterLabels` | Function | `Public Function GetFilterLabels() As IReadOnlyList(Of String)` |
| `RemoveFilterAt` | Function | `Public Function RemoveFilterAt(index As Integer) As MASAppliedFiltersBar` |
| `WithSavedViewName` | Function | `Public Function WithSavedViewName(value As String) As MASAppliedFiltersBar` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASAppliedFiltersBar` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASAppliedFiltersBar` |
| `FilterCount` | Property | `Public ReadOnly Property FilterCount As Integer` |
| `HasFilters` | Property | `Public ReadOnly Property HasFilters As Boolean` |
| `SavedViewName` | Property | `Public Property SavedViewName As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASAvatar`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Feedback/Avatar/MASAvatar.vb:25` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Avatar component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Clicked` | Event | `Public Event Clicked As EventHandler` |
| `SelectedChanged` | Event | `Public Event SelectedChanged As EventHandler` |
| `Create` | Function | `Public Shared Function Create(Optional displayName As String = Nothing, Optional initials As String = Nothing) As MASAvatar` |
| `WithAccentColor` | Function | `Public Function WithAccentColor(value As SKColor) As MASAvatar` |
| `WithDisplayName` | Function | `Public Function WithDisplayName(value As String) As MASAvatar` |
| `WithInitials` | Function | `Public Function WithInitials(value As String) As MASAvatar` |
| `WithPresence` | Function | `Public Function WithPresence(value As String, Optional visible As Boolean = True) As MASAvatar` |
| `WithSelected` | Function | `Public Function WithSelected(Optional value As Boolean = True) As MASAvatar` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASAvatar` |
| `AccentColor` | Property | `Public Property AccentColor As SKColor` |
| `DisplayName` | Property | `Public Property DisplayName As String` |
| `Initials` | Property | `Public Property Initials As String` |
| `PresenceText` | Property | `Public Property PresenceText As String` |
| `Selected` | Property | `Public Property Selected As Boolean` |
| `ShowPresence` | Property | `Public Property ShowPresence As Boolean` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASAvatarGroup`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Feedback/Avatar/MASAvatarGroup.vb:28` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Avatar Group component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `AvatarClicked` | Event | `Public Event AvatarClicked As EventHandler` |
| `SelectedIndexChanged` | Event | `Public Event SelectedIndexChanged As EventHandler` |
| `AddAvatar` | Function | `Public Function AddAvatar(avatar As MASAvatar) As MASAvatarGroup` |
| `AddAvatar` | Function | `Public Function AddAvatar(displayName As String, Optional initials As String = Nothing) As MASAvatarGroup` |
| `ClearAvatars` | Function | `Public Function ClearAvatars() As MASAvatarGroup` |
| `Create` | Function | `Public Shared Function Create(Optional avatars As IEnumerable(Of MASAvatar) = Nothing) As MASAvatarGroup` |
| `GetAvatar` | Function | `Public Function GetAvatar(index As Integer) As MASAvatar` |
| `RemoveAvatarAt` | Function | `Public Function RemoveAvatarAt(index As Integer) As MASAvatarGroup` |
| `WithMaxVisible` | Function | `Public Function WithMaxVisible(value As Integer) As MASAvatarGroup` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(index As Integer) As MASAvatarGroup` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASAvatarGroup` |
| `AvatarCount` | Property | `Public ReadOnly Property AvatarCount As Integer` |
| `MaxVisible` | Property | `Public Property MaxVisible As Integer` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASBreadcrumb`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/Breadcrumb/MASBreadcrumb.vb:27` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Breadcrumb component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectedIndexChanged` | Event | `Public Event SelectedIndexChanged As EventHandler` |
| `AddItem` | Function | `Public Function AddItem(text As String) As MASBreadcrumb` |
| `ClearItems` | Function | `Public Function ClearItems() As MASBreadcrumb` |
| `Create` | Function | `Public Shared Function Create(Optional items As IEnumerable(Of String) = Nothing) As MASBreadcrumb` |
| `GetItemText` | Function | `Public Function GetItemText(index As Integer) As String` |
| `SetItems` | Function | `Public Function SetItems(items As IEnumerable(Of String)) As MASBreadcrumb` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(index As Integer) As MASBreadcrumb` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASBreadcrumb` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `SelectedText` | Property | `Public ReadOnly Property SelectedText As String` |
| `SeparatorText` | Property | `Public Property SeparatorText As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASCalendarView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/CalendarView/MASCalendarView.Helpers.vb:21`<br>`Component/Inputs/CalendarView/MASCalendarView.Interaction.vb:21`<br>`Component/Inputs/CalendarView/MASCalendarView.Layout.vb:21`<br>`Component/Inputs/CalendarView/MASCalendarView.Motion.vb:12`<br>`Component/Inputs/CalendarView/MASCalendarView.Rendering.vb:21`<br>`Component/Inputs/CalendarView/MASCalendarView.vb:28` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Calendar View component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `DisplayMonthChanged` | Event | `Public Event DisplayMonthChanged As EventHandler` |
| `SelectedDateChanged` | Event | `Public Event SelectedDateChanged As EventHandler` |
| `ClearDate` | Function | `Public Function ClearDate() As MASCalendarView` |
| `Create` | Function | `Public Shared Function Create(Optional selectedDate As System.Nullable(Of Date) = Nothing, Optional displayMonth As System.Nullable(Of Date) = Nothing) As MASCalendarView` |
| `MoveNextMonth` | Function | `Public Function MoveNextMonth() As MASCalendarView` |
| `MovePreviousMonth` | Function | `Public Function MovePreviousMonth() As MASCalendarView` |
| `MoveToday` | Function | `Public Function MoveToday() As MASCalendarView` |
| `SelectDate` | Function | `Public Function SelectDate(value As Date) As MASCalendarView` |
| `WithDateRange` | Function | `Public Function WithDateRange(minimumDate As System.Nullable(Of Date), maximumDate As System.Nullable(Of Date)) As MASCalendarView` |
| `WithDisplayMonth` | Function | `Public Function WithDisplayMonth(value As Date) As MASCalendarView` |
| `WithOutsideDays` | Function | `Public Function WithOutsideDays(value As Boolean) As MASCalendarView` |
| `WithSelectedDate` | Function | `Public Function WithSelectedDate(value As Date) As MASCalendarView` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASCalendarView` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASCalendarView` |
| `DisplayMonth` | Property | `Public Property DisplayMonth As Date` |
| `MaximumDate` | Property | `Public Property MaximumDate As System.Nullable(Of Date)` |
| `MinimumDate` | Property | `Public Property MinimumDate As System.Nullable(Of Date)` |
| `MonthTitle` | Property | `Public ReadOnly Property MonthTitle As String` |
| `SelectedDate` | Property | `Public Property SelectedDate As System.Nullable(Of Date)` |
| `ShowOutsideDays` | Property | `Public Property ShowOutsideDays As Boolean` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASChart`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/Charts/Control/MASChart.Measurement.vb:12`<br>`Component/Data/Charts/Control/MASChart.Rendering.vb:16`<br>`Component/Data/Charts/Control/MASChart.vb:23` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Chart component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ChartChanged` | Event | `Public Event ChartChanged As EventHandler` |
| `AddPoint` | Function | `Public Function AddPoint(key As String, label As String, value As Double) As MASChart` |
| `AddPoint` | Function | `Public Function AddPoint(seriesKey As String, seriesLabel As String, key As String, label As String, value As Double) As MASChart` |
| `AddTrendPoint` | Function | `Public Function AddTrendPoint(key As String, label As String, value As Double, trendValue As Double) As MASChart` |
| `ClearSeries` | Function | `Public Function ClearSeries() As MASChart` |
| `Create` | Function | `Public Shared Function Create() As MASChart` |
| `WithBarChart` | Function | `Public Function WithBarChart(title As String) As MASChart` |
| `WithDonutChart` | Function | `Public Function WithDonutChart(title As String) As MASChart` |
| `WithKpiChart` | Function | `Public Function WithKpiChart(title As String) As MASChart` |
| `WithLineChart` | Function | `Public Function WithLineChart(title As String) As MASChart` |
| `WithPieChart` | Function | `Public Function WithPieChart(title As String) As MASChart` |
| `WithSparklineChart` | Function | `Public Function WithSparklineChart(title As String) As MASChart` |
| `WithTitle` | Function | `Public Function WithTitle(title As String) As MASChart` |
| `ChartKindName` | Property | `Public ReadOnly Property ChartKindName As String` |
| `HasData` | Property | `Public ReadOnly Property HasData As Boolean` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASChartLegend`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/ChartLegend/MASChartLegend.vb:30` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Chart Legend component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `LegendChanged` | Event | `Public Event LegendChanged As EventHandler` |
| `SelectedItemChanged` | Event | `Public Event SelectedItemChanged As EventHandler` |
| `AddItem` | Function | `Public Function AddItem(itemKey As String, label As String, Optional valueText As String = Nothing, Optional colorArgb As UInteger = 0) As MASChartLegend` |
| `ClearItems` | Function | `Public Function ClearItems() As MASChartLegend` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASChartLegend` |
| `GetItemKeys` | Function | `Public Function GetItemKeys() As IReadOnlyList(Of String)` |
| `MoveNext` | Function | `Public Function MoveNext() As MASChartLegend` |
| `MovePrevious` | Function | `Public Function MovePrevious() As MASChartLegend` |
| `SelectItem` | Function | `Public Function SelectItem(itemKey As String) As Boolean` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASChartLegend` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASChartLegend` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedItemKey` | Property | `Public ReadOnly Property SelectedItemKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASCheckBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/CheckBox/MASCheckBox.vb:24` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Check Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `CheckedChanged` | Event | `Public Event CheckedChanged As EventHandler` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing, Optional isChecked As Boolean = False) As MASCheckBox` |
| `SetChecked` | Sub | `Public Sub SetChecked(value As Boolean)` |
| `SetFocusVisual` | Sub | `Public Sub SetFocusVisual(value As Boolean)` |
| `Toggle` | Sub | `Public Sub Toggle()` |
| `WithChecked` | Function | `Public Function WithChecked(Optional value As Boolean = True) As MASCheckBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASCheckBox` |
| `WithText` | Function | `Public Function WithText(value As String) As MASCheckBox` |
| `Checked` | Property | `Public Property Checked As Boolean` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASColorPicker`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Editor/ColorPicker/MASColorPicker.Motion.vb:13`<br>`Component/Editor/ColorPicker/MASColorPicker.vb:21` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Color Picker component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ApplyColorChanged` | Event | `Public Event ApplyColorChanged As EventHandler` |
| `ColorChanged` | Event | `Public Event ColorChanged As EventHandler(Of MASColorPickerColorChangedEventArgs)` |
| `EditingEnded` | Event | `Public Event EditingEnded As EventHandler` |
| `EditingStarted` | Event | `Public Event EditingStarted As EventHandler` |
| `Create` | Function | `Public Shared Function Create() As MASColorPicker` |
| `Disable` | Function | `Public Function Disable() As MASColorPicker` |
| `Enable` | Function | `Public Function Enable() As MASColorPicker` |
| `Hide` | Function | `Public Function Hide() As MASColorPicker` |
| `OnApplyColorChanged` | Function | `Public Function OnApplyColorChanged(handler As Action(Of Boolean)) As MASColorPicker` |
| `OnApplyColorChanged` | Function | `Public Function OnApplyColorChanged(handler As EventHandler) As MASColorPicker` |
| `OnColorChanged` | Function | `Public Function OnColorChanged(handler As Action(Of MASColorPickerColorChangedEventArgs)) As MASColorPicker` |
| `OnColorChanged` | Function | `Public Function OnColorChanged(handler As Action(Of SKColor, SKColor)) As MASColorPicker` |
| `OnColorChanged` | Function | `Public Function OnColorChanged(handler As EventHandler(Of MASColorPickerColorChangedEventArgs)) As MASColorPicker` |
| `OnEditingEnded` | Function | `Public Function OnEditingEnded(handler As Action(Of MASColorPicker)) As MASColorPicker` |
| `OnEditingEnded` | Function | `Public Function OnEditingEnded(handler As EventHandler) As MASColorPicker` |
| `OnEditingStarted` | Function | `Public Function OnEditingStarted(handler As Action(Of MASColorPicker)) As MASColorPicker` |
| `OnEditingStarted` | Function | `Public Function OnEditingStarted(handler As EventHandler) As MASColorPicker` |
| `SetColors` | Sub | `Public Sub SetColors(primaryColor As SKColor, secondaryColor As SKColor, Optional activeSlot As System.Nullable(Of MASColorPickerSlot) = Nothing)` |
| `Show` | Function | `Public Function Show() As MASColorPicker` |
| `UsePrimarySlot` | Function | `Public Function UsePrimarySlot() As MASColorPicker` |
| `UseSecondarySlot` | Function | `Public Function UseSecondarySlot() As MASColorPicker` |
| `WithActiveSlot` | Function | `Public Function WithActiveSlot(slot As MASColorPickerSlot) As MASColorPicker` |
| `WithApplyColorChecked` | Function | `Public Function WithApplyColorChecked(checkedValue As Boolean) As MASColorPicker` |
| `WithApplyColorOption` | Function | `Public Function WithApplyColorOption(enabled As Boolean) As MASColorPicker` |
| `WithApplyColorText` | Function | `Public Function WithApplyColorText(text As String) As MASColorPicker` |
| `WithColors` | Function | `Public Function WithColors(primaryColor As SKColor, secondaryColor As SKColor) As MASColorPicker` |
| `WithEnabled` | Function | `Public Function WithEnabled(value As Boolean) As MASColorPicker` |
| `WithPrimaryColor` | Function | `Public Function WithPrimaryColor(color As SKColor) As MASColorPicker` |
| `WithSecondaryColor` | Function | `Public Function WithSecondaryColor(color As SKColor) As MASColorPicker` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASColorPicker` |
| `WithVisible` | Function | `Public Function WithVisible(value As Boolean) As MASColorPicker` |
| `ActiveColor` | Property | `Public ReadOnly Property ActiveColor As SKColor` |
| `ActiveSlot` | Property | `Public Property ActiveSlot As MASColorPickerSlot` |
| `ApplyColorChecked` | Property | `Public Property ApplyColorChecked As Boolean` |
| `ApplyColorText` | Property | `Public Property ApplyColorText As String` |
| `PrimaryColor` | Property | `Public Property PrimaryColor As SKColor` |
| `SecondaryColor` | Property | `Public Property SecondaryColor As SKColor` |
| `ShowApplyColorOption` | Property | `Public Property ShowApplyColorOption As Boolean` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASColorPickerColorChangedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Editor/ColorPicker/MASColorPickerColorChangedEventArgs.vb:9` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Carries typed event data for Color Picker Color Changed Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ActiveSlot` | Property | `Public ReadOnly Property ActiveSlot As MASColorPickerSlot` |
| `IsLivePreview` | Property | `Public ReadOnly Property IsLivePreview As Boolean` |
| `PrimaryColor` | Property | `Public ReadOnly Property PrimaryColor As SKColor` |
| `SecondaryColor` | Property | `Public ReadOnly Property SecondaryColor As SKColor` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASComboBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/ComboBox/MASComboBox.Api.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.Dropdown.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.Helpers.vb:25`<br>`Component/Inputs/ComboBox/MASComboBox.Input.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.Items.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.Lifetime.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.Properties.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.Rendering.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.RuntimeServices.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.State.vb:24`<br>`Component/Inputs/ComboBox/MASComboBox.vb:30` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Combo Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddItems` | Sub | `Public Sub AddItems(items As IEnumerable(Of String))` |
| `AddRange` | Function | `Public Function AddRange(items As IEnumerable(Of String)) As MASComboBox` |
| `ClearItems` | Sub | `Public Sub ClearItems()` |
| `Clear` | Function | `Public Function Clear() As MASComboBox` |
| `Create` | Function | `Public Shared Function Create() As MASComboBox` |
| `SelectFirstItem` | Function | `Public Function SelectFirstItem() As MASComboBox` |
| `SelectFirst` | Sub | `Public Sub SelectFirst()` |
| `SelectIndex` | Function | `Public Function SelectIndex(index As Integer) As MASComboBox` |
| `SetItems` | Sub | `Public Sub SetItems(items As IEnumerable(Of String))` |
| `WithItems` | Function | `Public Function WithItems(items As IEnumerable(Of String)) As MASComboBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASComboBox` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `Items` | Property | `Public ReadOnly Property Items As IReadOnlyList(Of String)` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `SelectedText` | Property | `Public ReadOnly Property SelectedText As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASContentCarousel`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/ContentCarousel/MASContentCarousel.Events.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.Geometry.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.Interaction.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.ItemModel.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.Layout.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.Lifetime.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.PointerState.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.Rendering.Cards.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.Rendering.Navigation.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.Rendering.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.ViewState.vb:22`<br>`Component/Navigation/ContentCarousel/MASContentCarousel.vb:30` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Content Carousel component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ContentCarouselChanged` | Event | `Public Event ContentCarouselChanged As EventHandler` |
| `SelectedItemChanged` | Event | `Public Event SelectedItemChanged As EventHandler` |
| `AddItem` | Function | `Public Function AddItem(itemKey As String, title As String, Optional subtitle As String = Nothing, Optional detail As String = Nothing) As MASContentCarousel` |
| `ClearItems` | Function | `Public Function ClearItems() As MASContentCarousel` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASContentCarousel` |
| `GetItemKeys` | Function | `Public Function GetItemKeys() As IReadOnlyList(Of String)` |
| `MoveFirst` | Function | `Public Function MoveFirst() As MASContentCarousel` |
| `MoveLast` | Function | `Public Function MoveLast() As MASContentCarousel` |
| `MoveNext` | Function | `Public Function MoveNext() As MASContentCarousel` |
| `MovePrevious` | Function | `Public Function MovePrevious() As MASContentCarousel` |
| `SelectItem` | Function | `Public Function SelectItem(itemKey As String) As Boolean` |
| `WithLooping` | Function | `Public Function WithLooping(value As Boolean) As MASContentCarousel` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASContentCarousel` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASContentCarousel` |
| `IsLooping` | Property | `Public Property IsLooping As Boolean` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedItemKey` | Property | `Public ReadOnly Property SelectedItemKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDashboardGrid`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DashboardGrid/MASDashboardGrid.Hosting.vb:12`<br>`Component/Data/DashboardGrid/MASDashboardGrid.KeyboardResizeThresholds.vb:126`<br>`Component/Data/DashboardGrid/MASDashboardGrid.Motion.vb:13`<br>`Component/Data/DashboardGrid/MASDashboardGrid.Persistence.vb:69`<br>`Component/Data/DashboardGrid/MASDashboardGrid.ProviderAdapterPolicy.vb:90`<br>`Component/Data/DashboardGrid/MASDashboardGrid.ProviderRefresh.vb:154`<br>`Component/Data/DashboardGrid/MASDashboardGrid.WidgetWindow.vb:101`<br>`Component/Data/DashboardGrid/MASDashboardGrid.vb:28` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the advanced Dashboard Grid component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `DashboardGridChanged` | Event | `Public Event DashboardGridChanged As EventHandler` |
| `SelectedWidgetChanged` | Event | `Public Event SelectedWidgetChanged As EventHandler` |
| `AddWidget` | Function | `Public Function AddWidget(widgetKey As String, title As String, valueText As String, Optional caption As String = Nothing, Optional spanColumns As Integer = 1, Optional spanRows As Integer = 1) As MASDashboardGrid` |
| `ClearWidgets` | Function | `Public Function ClearWidgets() As MASDashboardGrid` |
| `CreateLayoutSnapshot` | Function | `Public Function CreateLayoutSnapshot() As MASDashboardGridLayoutSnapshot` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASDashboardGrid` |
| `GetWidgetKeys` | Function | `Public Function GetWidgetKeys() As IReadOnlyList(Of String)` |
| `MoveNext` | Function | `Public Function MoveNext() As MASDashboardGrid` |
| `MovePrevious` | Function | `Public Function MovePrevious() As MASDashboardGrid` |
| `MoveWidget` | Function | `Public Function MoveWidget(widgetKey As String, targetIndex As Integer) As Boolean` |
| `ResetWidgetViewport` | Function | `Public Function ResetWidgetViewport() As MASDashboardGrid` |
| `ResizeWidget` | Function | `Public Function ResizeWidget(widgetKey As String, spanColumns As Integer, spanRows As Integer) As Boolean` |
| `RestoreLayoutSnapshot` | Function | `Public Function RestoreLayoutSnapshot(snapshot As MASDashboardGridLayoutSnapshot) As Boolean` |
| `SelectWidget` | Function | `Public Function SelectWidget(widgetKey As String) As Boolean` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASDashboardGrid` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASDashboardGrid` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedWidgetKey` | Property | `Public ReadOnly Property SelectedWidgetKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDashboardGridLayoutSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Data/DashboardGrid/MASDashboardGrid.Persistence.vb:17` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Represents a captured state snapshot for the Dashboard Grid Layout Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(version As Integer, title As String, selectedWidgetKey As String, topIndex As Integer, widgets As IEnumerable(Of MASDashboardGridWidgetSnapshot))` |
| `SelectedWidgetKey` | Property | `Public ReadOnly Property SelectedWidgetKey As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |
| `TopIndex` | Property | `Public ReadOnly Property TopIndex As Integer` |
| `Version` | Property | `Public ReadOnly Property Version As Integer` |
| `Widgets` | Property | `Public ReadOnly Property Widgets As IReadOnlyList(Of MASDashboardGridWidgetSnapshot)` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDashboardGridWidgetSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Data/DashboardGrid/MASDashboardGrid.Persistence.vb:46` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Represents a captured state snapshot for the Dashboard Grid Widget Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(key As String, title As String, valueText As String, caption As String, spanColumns As Integer, spanRows As Integer)` |
| `Caption` | Property | `Public ReadOnly Property Caption As String` |
| `Key` | Property | `Public ReadOnly Property Key As String` |
| `SpanColumns` | Property | `Public ReadOnly Property SpanColumns As Integer` |
| `SpanRows` | Property | `Public ReadOnly Property SpanRows As Integer` |
| `Title` | Property | `Public ReadOnly Property Title As String` |
| `ValueText` | Property | `Public ReadOnly Property ValueText As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDataForm`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/DataForm/MASDataForm.Helpers.vb:21`<br>`Component/Inputs/DataForm/MASDataForm.Interaction.vb:21`<br>`Component/Inputs/DataForm/MASDataForm.ItemModel.vb:21`<br>`Component/Inputs/DataForm/MASDataForm.Layout.vb:21`<br>`Component/Inputs/DataForm/MASDataForm.Rendering.vb:21`<br>`Component/Inputs/DataForm/MASDataForm.vb:28` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Data Form component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `FieldsChanged` | Event | `Public Event FieldsChanged As EventHandler` |
| `AddField` | Function | `Public Function AddField(label As String, valueText As String, Optional kind As MASDataFormFieldKind = MASDataFormFieldKind.Text, Optional state As MASDataFormFieldState = MASDataFormFieldState.Normal, Optional helperText As String = "", Optional required As Boolean = False) As MASDataForm` |
| `ClearFields` | Function | `Public Function ClearFields() As MASDataForm` |
| `Create` | Function | `Public Shared Function Create(Optional configure As Action(Of MASFormBuilder) = Nothing) As MASDataForm` |
| `GetFieldLabel` | Function | `Public Function GetFieldLabel(index As Integer) As String` |
| `GetFieldValue` | Function | `Public Function GetFieldValue(index As Integer) As String` |
| `SetFields` | Function | `Public Function SetFields(builder As MASFormBuilder) As MASDataForm` |
| `WithCompact` | Function | `Public Function WithCompact(Optional compact As Boolean = True) As MASDataForm` |
| `WithDescription` | Function | `Public Function WithDescription(description As String) As MASDataForm` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASDataForm` |
| `WithTitle` | Function | `Public Function WithTitle(title As String) As MASDataForm` |
| `Compact` | Property | `Public Property Compact As Boolean` |
| `Description` | Property | `Public Property Description As String` |
| `FieldCount` | Property | `Public ReadOnly Property FieldCount As Integer` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDataGrid`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Control/MASDataGrid.Accessibility.vb:9`<br>`Component/Data/DataGrid/Control/MASDataGrid.Columns.vb:26`<br>`Component/Data/DataGrid/Control/MASDataGrid.Editing.vb:26`<br>`Component/Data/DataGrid/Control/MASDataGrid.Fluent.vb:9`<br>`Component/Data/DataGrid/Control/MASDataGrid.Input.vb:26`<br>`Component/Data/DataGrid/Control/MASDataGrid.Layout.vb:28`<br>`Component/Data/DataGrid/Control/MASDataGrid.Motion.vb:9`<br>`Component/Data/DataGrid/Control/MASDataGrid.Rows.vb:26`<br>`Component/Data/DataGrid/Control/MASDataGrid.Selection.vb:26`<br>`Component/Data/DataGrid/Control/MASDataGrid.Sorting.vb:26`<br>`Component/Data/DataGrid/Control/MASDataGrid.Virtualization.vb:26`<br>`Component/Data/DataGrid/Control/MASDataGrid.vb:31` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** An advanced product data-grid component for tabular data interaction.

**When to use it.** Use it for high-value tabular scenarios; prefer documented recipes and Application control factories where available.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `CellValueChanged` | Event | `Public Event CellValueChanged As EventHandler(Of MASDataGridCellValueChangedEventArgs)` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddColumn` | Function | `Public Function AddColumn(column As MASDataGridColumn) As MASDataGridColumn` |
| `AddColumn` | Function | `Public Function AddColumn(key As String, headerText As String) As MASDataGridColumn` |
| `AddRows` | Function | `Public Function AddRows(rows As IEnumerable(Of MASDataGridRow)) As IReadOnlyList(Of MASDataGridRow)` |
| `AddRows` | Function | `Public Function AddRows(valueRows As IEnumerable(Of Object())) As IReadOnlyList(Of MASDataGridRow)` |
| `AddRow` | Function | `Public Function AddRow(row As MASDataGridRow) As MASDataGridRow` |
| `AddRow` | Function | `Public Function AddRow(values As Object()) As MASDataGridRow` |
| `BeginCellEdit` | Function | `Public Function BeginCellEdit(rowIndex As Integer, columnIndex As Integer) As Boolean` |
| `BeginUpdate` | Function | `Public Function BeginUpdate() As System.IDisposable` |
| `CancelCellEdit` | Sub | `Public Sub CancelCellEdit()` |
| `ClearSort` | Function | `Public Function ClearSort() As MASDataGrid` |
| `CommitCellEdit` | Function | `Public Function CommitCellEdit(value As Object) As Boolean` |
| `CopySelectionText` | Function | `Public Function CopySelectionText() As String` |
| `LoadRows` | Function | `Public Function LoadRows(rows As IEnumerable(Of MASDataGridRow)) As MASDataGrid` |
| `LoadRows` | Function | `Public Function LoadRows(valueRows As IEnumerable(Of Object())) As MASDataGrid` |
| `SetColumnWidth` | Function | `Public Function SetColumnWidth(columnIndex As Integer, widthDip As Single) As MASDataGrid` |
| `SetDataView` | Function | `Public Function SetDataView(view As MASDataView) As MASDataGrid` |
| `SetFilterText` | Function | `Public Function SetFilterText(filterText As String) As MASDataGrid` |
| `SortByColumn` | Function | `Public Function SortByColumn(columnKey As String, direction As MASDataGridSortDirection) As MASDataGrid` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASDataGrid` |
| `Columns` | Property | `Public ReadOnly Property Columns As IReadOnlyList(Of MASDataGridColumn)` |
| `DataView` | Property | `Public ReadOnly Property DataView As MASDataView` |
| `HeaderHeightDip` | Property | `Public Property HeaderHeightDip As Single` |
| `RowHeightDip` | Property | `Public Property RowHeightDip As Single` |
| `Rows` | Property | `Public ReadOnly Property Rows As IReadOnlyList(Of MASDataGridRow)` |
| `SelectedColumnIndex` | Property | `Public Property SelectedColumnIndex As Integer` |
| `SelectedRowIndex` | Property | `Public Property SelectedRowIndex As Integer` |
| `SelectionMode` | Property | `Public Property SelectionMode As MASDataGridSelectionMode` |
| `SummaryAutoPreparationRowLimit` | Property | `Public Property SummaryAutoPreparationRowLimit As Integer` |
| `SummaryFooterMode` | Property | `Public Property SummaryFooterMode As MASDataGridSummaryFooterMode` |
| `VisibleRowCount` | Property | `Public ReadOnly Property VisibleRowCount As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDataGridCellAddress`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Editing/MASDataGridCellAddress.vb:10` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Data Grid Cell Address component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(rowIndex As Integer, columnIndex As Integer)` |
| `ColumnIndex` | Property | `Public ReadOnly Property ColumnIndex As Integer` |
| `IsValid` | Property | `Public ReadOnly Property IsValid As Boolean` |
| `RowIndex` | Property | `Public ReadOnly Property RowIndex As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDataGridCellValueChangedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Editing/MASDataGridCellValueChangedEventArgs.vb:12` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Carries typed event data for Data Grid Cell Value Changed Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Address` | Property | `Public ReadOnly Property Address As MASDataGridCellAddress` |
| `NewValue` | Property | `Public ReadOnly Property NewValue As Object` |
| `OldValue` | Property | `Public ReadOnly Property OldValue As Object` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASDataGridColumn`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Model/MASDataGridColumn.vb:12` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides a typed model/DTO used by the Data Grid Column control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(key As String, headerText As String)` |
| `ReadOnlyColumn` | Function | `Public Function ReadOnlyColumn() As MASDataGridColumn` |
| `WithWidth` | Function | `Public Function WithWidth(widthDip As Single) As MASDataGridColumn` |
| `CanResize` | Property | `Public Property CanResize As Boolean` |
| `CanSort` | Property | `Public Property CanSort As Boolean` |
| `FormatString` | Property | `Public Property FormatString As String` |
| `HeaderText` | Property | `Public Property HeaderText As String` |
| `IsReadOnly` | Property | `Public Property IsReadOnly As Boolean` |
| `IsVisible` | Property | `Public Property IsVisible As Boolean` |
| `Key` | Property | `Public ReadOnly Property Key As String` |
| `MinWidthDip` | Property | `Public Property MinWidthDip As Single` |
| `TextAlignment` | Property | `Public Property TextAlignment As MASHorizontalAlignment` |
| `ValueTypeCode` | Property | `Public Property ValueTypeCode As System.TypeCode` |
| `WidthDip` | Property | `Public Property WidthDip As Single` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDataGridRow`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Model/MASDataGridRow.vb:15` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides a typed model/DTO used by the Data Grid Row control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `GetText` | Function | `Public Function GetText(columnKey As String) As String` |
| `GetValue` | Function | `Public Function GetValue(columnKey As String) As Object` |
| `SetValue` | Function | `Public Function SetValue(columnKey As String, value As Object) As MASDataGridRow` |
| `Values` | Property | `Public ReadOnly Property Values As IReadOnlyDictionary(Of String, Object)` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDataView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Model/MASDataView.vb:17` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** An advanced data view component for structured records and product data presentation.

**When to use it.** Use it when a record-oriented data surface is more appropriate than a simple list or grid.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Changed` | Event | `Public Event Changed As EventHandler` |
| `AddColumn` | Function | `Public Function AddColumn(column As MASDataGridColumn) As MASDataGridColumn` |
| `AddColumn` | Function | `Public Function AddColumn(key As String, headerText As String) As MASDataGridColumn` |
| `AddRows` | Function | `Public Function AddRows(rows As IEnumerable(Of MASDataGridRow)) As IReadOnlyList(Of MASDataGridRow)` |
| `AddRows` | Function | `Public Function AddRows(valueRows As IEnumerable(Of Object())) As IReadOnlyList(Of MASDataGridRow)` |
| `AddRow` | Function | `Public Function AddRow(row As MASDataGridRow) As MASDataGridRow` |
| `AddRow` | Function | `Public Function AddRow(values As Object()) As MASDataGridRow` |
| `ClearColumns` | Sub | `Public Sub ClearColumns()` |
| `ClearRows` | Sub | `Public Sub ClearRows()` |
| `ClearSort` | Sub | `Public Sub ClearSort()` |
| `DeferRefresh` | Function | `Public Function DeferRefresh() As System.IDisposable` |
| `GetSourceRowIndexForVisibleRow` | Function | `Public Function GetSourceRowIndexForVisibleRow(visibleIndex As Integer) As Integer` |
| `GetVisibleRow` | Function | `Public Function GetVisibleRow(visibleIndex As Integer) As MASDataGridRow` |
| `Refresh` | Function | `Public Function Refresh() As MASDataView` |
| `ReplaceRows` | Function | `Public Function ReplaceRows(rows As IEnumerable(Of MASDataGridRow)) As MASDataView` |
| `ReplaceRows` | Function | `Public Function ReplaceRows(valueRows As IEnumerable(Of Object())) As MASDataView` |
| `SetFilterText` | Sub | `Public Sub SetFilterText(filterText As String)` |
| `SortByColumn` | Sub | `Public Sub SortByColumn(columnKey As String, direction As MASDataGridSortDirection)` |
| `Columns` | Property | `Public ReadOnly Property Columns As IReadOnlyList(Of MASDataGridColumn)` |
| `FilterText` | Property | `Public ReadOnly Property FilterText As String` |
| `Rows` | Property | `Public ReadOnly Property Rows As IReadOnlyList(Of MASDataGridRow)` |
| `SortColumnKey` | Property | `Public ReadOnly Property SortColumnKey As String` |
| `SortDirection` | Property | `Public ReadOnly Property SortDirection As MASDataGridSortDirection` |
| `VisibleRowCount` | Property | `Public ReadOnly Property VisibleRowCount As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDatePicker`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/DatePicker/MASDatePicker.Events.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.Geometry.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.Interaction.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.Layout.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.Parsing.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.Popup.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.Rendering.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.ViewState.vb:22`<br>`Component/Inputs/DatePicker/MASDatePicker.vb:27` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Date Picker component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectedDateChanged` | Event | `Public Event SelectedDateChanged As EventHandler` |
| `ClearDate` | Function | `Public Function ClearDate() As MASDatePicker` |
| `Create` | Function | `Public Shared Function Create() As MASDatePicker` |
| `WithDateRange` | Function | `Public Function WithDateRange(minimumDate As System.Nullable(Of Date), maximumDate As System.Nullable(Of Date)) As MASDatePicker` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASDatePicker` |
| `WithSelectedDate` | Function | `Public Function WithSelectedDate(value As Date) As MASDatePicker` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASDatePicker` |
| `DisplayText` | Property | `Public ReadOnly Property DisplayText As String` |
| `MaximumDate` | Property | `Public Property MaximumDate As System.Nullable(Of Date)` |
| `MinimumDate` | Property | `Public Property MinimumDate As System.Nullable(Of Date)` |
| `Placeholder` | Property | `Public Property Placeholder As String` |
| `SelectedDate` | Property | `Public Property SelectedDate As System.Nullable(Of Date)` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDateRangePicker`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/DateRangePicker/MASDateRangePicker.Motion.vb:12`<br>`Component/Inputs/DateRangePicker/MASDateRangePicker.vb:26` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Date Range Picker component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `RangeChanged` | Event | `Public Event RangeChanged As EventHandler` |
| `ClearRange` | Function | `Public Function ClearRange() As MASDateRangePicker` |
| `Create` | Function | `Public Shared Function Create(Optional startDate As System.Nullable(Of Date) = Nothing, Optional endDate As System.Nullable(Of Date) = Nothing) As MASDateRangePicker` |
| `WithDateBounds` | Function | `Public Function WithDateBounds(minimumDate As System.Nullable(Of Date), maximumDate As System.Nullable(Of Date)) As MASDateRangePicker` |
| `WithPlaceholders` | Function | `Public Function WithPlaceholders(startPlaceholder As String, endPlaceholder As String) As MASDateRangePicker` |
| `WithRange` | Function | `Public Function WithRange(startDate As System.Nullable(Of Date), endDate As System.Nullable(Of Date)) As MASDateRangePicker` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASDateRangePicker` |
| `DisplayText` | Property | `Public ReadOnly Property DisplayText As String` |
| `EndDate` | Property | `Public Property EndDate As System.Nullable(Of Date)` |
| `EndPlaceholder` | Property | `Public Property EndPlaceholder As String` |
| `MaximumDate` | Property | `Public Property MaximumDate As System.Nullable(Of Date)` |
| `MinimumDate` | Property | `Public Property MinimumDate As System.Nullable(Of Date)` |
| `StartDate` | Property | `Public Property StartDate As System.Nullable(Of Date)` |
| `StartPlaceholder` | Property | `Public Property StartPlaceholder As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASFileDropZone`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FileDropZone/MASFileDropZone.Events.vb:22`<br>`Component/Navigation/FileDropZone/MASFileDropZone.FileState.vb:22`<br>`Component/Navigation/FileDropZone/MASFileDropZone.Geometry.vb:22`<br>`Component/Navigation/FileDropZone/MASFileDropZone.Interaction.vb:22`<br>`Component/Navigation/FileDropZone/MASFileDropZone.Layout.vb:22`<br>`Component/Navigation/FileDropZone/MASFileDropZone.Rendering.Rows.vb:22`<br>`Component/Navigation/FileDropZone/MASFileDropZone.Rendering.vb:22`<br>`Component/Navigation/FileDropZone/MASFileDropZone.vb:29` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced File Drop Zone component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `BrowseRequested` | Event | `Public Event BrowseRequested As EventHandler` |
| `FilesChanged` | Event | `Public Event FilesChanged As EventHandler` |
| `AcceptDroppedFiles` | Function | `Public Function AcceptDroppedFiles(paths As IEnumerable(Of String)) As Integer` |
| `AcceptDroppedFile` | Function | `Public Function AcceptDroppedFile(path As String) As Boolean` |
| `ClearFiles` | Function | `Public Function ClearFiles() As MASFileDropZone` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional description As String = Nothing) As MASFileDropZone` |
| `RemoveFileAt` | Function | `Public Function RemoveFileAt(index As Integer) As MASFileDropZone` |
| `SetAllowedExtensions` | Function | `Public Function SetAllowedExtensions(extensions As String()) As MASFileDropZone` |
| `SetFiles` | Function | `Public Function SetFiles(paths As IEnumerable(Of String)) As MASFileDropZone` |
| `WithAllowedExtensions` | Function | `Public Function WithAllowedExtensions(extensions As String()) As MASFileDropZone` |
| `WithBrowseActionText` | Function | `Public Function WithBrowseActionText(value As String) As MASFileDropZone` |
| `WithDescription` | Function | `Public Function WithDescription(value As String) As MASFileDropZone` |
| `WithMultipleSelection` | Function | `Public Function WithMultipleSelection(value As Boolean) As MASFileDropZone` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASFileDropZone` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASFileDropZone` |
| `AcceptedFiles` | Property | `Public ReadOnly Property AcceptedFiles As IReadOnlyList(Of String)` |
| `AllowedExtensionsText` | Property | `Public ReadOnly Property AllowedExtensionsText As String` |
| `BrowseActionText` | Property | `Public Property BrowseActionText As String` |
| `Description` | Property | `Public Property Description As String` |
| `FileCount` | Property | `Public ReadOnly Property FileCount As Integer` |
| `LastRejectedReason` | Property | `Public ReadOnly Property LastRejectedReason As String` |
| `MultipleSelection` | Property | `Public Property MultipleSelection As Boolean` |
| `RejectedFileCount` | Property | `Public ReadOnly Property RejectedFileCount As Integer` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASFileExplorerItem`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FileExplorer/Core/MASFileExplorerItem.vb:9` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides a typed model/DTO used by the File Explorer Item control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(name As String, kind As MASFileExplorerItemKind)` |
| `New` | Sub | `Public Sub New()` |
| `AddChild` | Sub | `Public Sub AddChild(item As MASFileExplorerItem)` |
| `AddFile` | Function | `Public Function AddFile(name As String) As MASFileExplorerItem` |
| `AddFolder` | Function | `Public Function AddFolder(name As String) As MASFileExplorerItem` |
| `BuildCanonicalPath` | Function | `Public Function BuildCanonicalPath() As String` |
| `ClearChildren` | Sub | `Public Sub ClearChildren()` |
| `RemoveChild` | Function | `Public Function RemoveChild(item As MASFileExplorerItem) As Boolean` |
| `ToString` | Function | `Public Function ToString() As String` |
| `CanHaveChildren` | Property | `Public Property CanHaveChildren As Boolean` |
| `ChildrenLoaded` | Property | `Public Property ChildrenLoaded As Boolean` |
| `Children` | Property | `Public ReadOnly Property Children As IReadOnlyList(Of MASFileExplorerItem)` |
| `DisplayName` | Property | `Public Property DisplayName As String` |
| `EffectivePath` | Property | `Public ReadOnly Property EffectivePath As String` |
| `FileExtension` | Property | `Public Property FileExtension As String` |
| `FullPath` | Property | `Public Property FullPath As String` |
| `HasChildren` | Property | `Public ReadOnly Property HasChildren As Boolean` |
| `HasPhysicalPath` | Property | `Public ReadOnly Property HasPhysicalPath As Boolean` |
| `IconKind` | Property | `Public Property IconKind As MASIconObjectKind` |
| `IsFile` | Property | `Public ReadOnly Property IsFile As Boolean` |
| `IsFolder` | Property | `Public ReadOnly Property IsFolder As Boolean` |
| `IsRoot` | Property | `Public ReadOnly Property IsRoot As Boolean` |
| `IsVirtual` | Property | `Public Property IsVirtual As Boolean` |
| `Kind` | Property | `Public Property Kind As MASFileExplorerItemKind` |
| `LastWriteTime` | Property | `Public Property LastWriteTime As System.Nullable(Of Date)` |
| `LocationKind` | Property | `Public Property LocationKind As MASFileExplorerLocationKind` |
| `Name` | Property | `Public Property Name As String` |
| `Parent` | Property | `Public ReadOnly Property Parent As MASFileExplorerItem` |
| `ParsingPath` | Property | `Public Property ParsingPath As String` |
| `SizeBytes` | Property | `Public Property SizeBytes As System.Nullable(Of Long)` |
| `Tag` | Property | `Public Property Tag As Object` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASFileExplorerItemActivatedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FileExplorer/Core/MASFileExplorerView.vb:31` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed event data for File Explorer Item Activated Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Item` | Property | `Public ReadOnly Property Item As MASFileExplorerItem` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASFileExplorerView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FileExplorer/Core/MASFileExplorerView.Api.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.ContextCommands.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.InnerEvents.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.Input.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.Lifetime.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.Measurement.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.PanelShell.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.Rendering.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.SizeFluent.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.Sorting.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.State.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.ViewMode.vb:24`<br>`Component/Navigation/FileExplorer/Core/MASFileExplorerView.vb:44` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced File Explorer View component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `CloseRequested` | Event | `Public Event CloseRequested As EventHandler` |
| `CurrentFolderChanged` | Event | `Public Event CurrentFolderChanged As EventHandler` |
| `ExplorerItemActivated` | Event | `Public Event ExplorerItemActivated As EventHandler(Of MASFileExplorerItemActivatedEventArgs)` |
| `NavigationStateChanged` | Event | `Public Event NavigationStateChanged As EventHandler` |
| `SelectedItemChanged` | Event | `Public Event SelectedItemChanged As EventHandler` |
| `AddRootFolder` | Function | `Public Function AddRootFolder(name As String) As MASFileExplorerItem` |
| `AddRoot` | Sub | `Public Sub AddRoot(root As MASFileExplorerItem)` |
| `ClearExplorerItems` | Sub | `Public Sub ClearExplorerItems()` |
| `ClearExplorer` | Function | `Public Function ClearExplorer() As MASFileExplorerView` |
| `ClearSearch` | Function | `Public Function ClearSearch() As MASFileExplorerView` |
| `Create` | Function | `Public Shared Function Create() As MASFileExplorerView` |
| `FocusExplorer` | Function | `Public Function FocusExplorer() As MASFileExplorerView` |
| `FocusList` | Function | `Public Function FocusList() As MASFileExplorerView` |
| `FocusSearch` | Function | `Public Function FocusSearch() As MASFileExplorerView` |
| `FocusTree` | Function | `Public Function FocusTree() As MASFileExplorerView` |
| `GoBackFluent` | Function | `Public Function GoBackFluent() As MASFileExplorerView` |
| `GoBack` | Function | `Public Function GoBack() As Boolean` |
| `GoForwardFluent` | Function | `Public Function GoForwardFluent() As MASFileExplorerView` |
| `GoForward` | Function | `Public Function GoForward() As Boolean` |
| `LoadDefaultComputerRoot` | Sub | `Public Sub LoadDefaultComputerRoot()` |
| `NavigateToFolder` | Sub | `Public Sub NavigateToFolder(folder As MASFileExplorerItem)` |
| `NavigateTo` | Function | `Public Function NavigateTo(folder As MASFileExplorerItem) As MASFileExplorerView` |
| `NavigateUpFluent` | Function | `Public Function NavigateUpFluent() As MASFileExplorerView` |
| `NavigateUp` | Function | `Public Function NavigateUp() As Boolean` |
| `RebuildFromModel` | Sub | `Public Sub RebuildFromModel()` |
| `RefreshCurrentFolder` | Function | `Public Function RefreshCurrentFolder() As Boolean` |
| `RefreshExplorer` | Function | `Public Function RefreshExplorer() As MASFileExplorerView` |
| `Reload` | Function | `Public Function Reload() As MASFileExplorerView` |
| `SetViewMode` | Function | `Public Function SetViewMode(mode As MASListViewMode) As Boolean` |
| `WithCloseButton` | Function | `Public Function WithCloseButton(Optional visible As Boolean = True) As MASFileExplorerView` |
| `WithComputerRoot` | Function | `Public Function WithComputerRoot() As MASFileExplorerView` |
| `WithDefaultComputerRoot` | Function | `Public Function WithDefaultComputerRoot() As MASFileExplorerView` |
| `WithDetailsView` | Function | `Public Function WithDetailsView() As MASFileExplorerView` |
| `WithLargeIconsView` | Function | `Public Function WithLargeIconsView() As MASFileExplorerView` |
| `WithListView` | Function | `Public Function WithListView() As MASFileExplorerView` |
| `WithLocation` | Function | `Public Function WithLocation(x As Single, y As Single) As MASFileExplorerView` |
| `WithRootFolder` | Function | `Public Function WithRootFolder(name As String) As MASFileExplorerView` |
| `WithRoot` | Function | `Public Function WithRoot(root As MASFileExplorerItem) As MASFileExplorerView` |
| `WithSearchPlaceholder` | Function | `Public Function WithSearchPlaceholder(text As String) As MASFileExplorerView` |
| `WithSearchText` | Function | `Public Function WithSearchText(text As String) As MASFileExplorerView` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASFileExplorerView` |
| `WithSize` | Function | `Public Function WithSize(width As Single, height As Single) As MASFileExplorerView` |
| `WithSplitGap` | Function | `Public Function WithSplitGap(valueDip As Single) As MASFileExplorerView` |
| `WithTilesView` | Function | `Public Function WithTilesView() As MASFileExplorerView` |
| `WithTreeWidthRatio` | Function | `Public Function WithTreeWidthRatio(value As Single) As MASFileExplorerView` |
| `WithViewMode` | Function | `Public Function WithViewMode(mode As MASListViewMode) As MASFileExplorerView` |
| `WithoutCloseButton` | Function | `Public Function WithoutCloseButton() As MASFileExplorerView` |
| `CanGoBack` | Property | `Public ReadOnly Property CanGoBack As Boolean` |
| `CanGoForward` | Property | `Public ReadOnly Property CanGoForward As Boolean` |
| `CanNavigateUp` | Property | `Public ReadOnly Property CanNavigateUp As Boolean` |
| `CurrentDisplayPath` | Property | `Public ReadOnly Property CurrentDisplayPath As String` |
| `CurrentFolder` | Property | `Public ReadOnly Property CurrentFolder As MASFileExplorerItem` |
| `CurrentPath` | Property | `Public ReadOnly Property CurrentPath As String` |
| `ListView` | Property | `Public ReadOnly Property ListView As MASListView` |
| `SearchBox` | Property | `Public ReadOnly Property SearchBox As MASSearchTextBox` |
| `SelectedItems` | Property | `Public ReadOnly Property SelectedItems As IReadOnlyList(Of MASFileExplorerItem)` |
| `SelectedItem` | Property | `Public ReadOnly Property SelectedItem As MASFileExplorerItem` |
| `ShowCloseButton` | Property | `Public Property ShowCloseButton As Boolean` |
| `SplitGapDip` | Property | `Public Property SplitGapDip As Single` |
| `TreeView` | Property | `Public ReadOnly Property TreeView As MASTreeView` |
| `TreeWidthRatio` | Property | `Public Property TreeWidthRatio As Single` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASFilePickerControl`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FilePicker/Control/MASFilePickerControl.Api.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Commands.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.ContextCommands.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.EventHandlers.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Fluent.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Focus.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Helpers.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Layout.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Lifetime.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Measurement.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.PanelShell.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.Rendering.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.RuntimeServices.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.SizeFluent.vb:22`<br>`Component/Navigation/FilePicker/Control/MASFilePickerControl.vb:21` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced File Picker Control component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(options As MASFilePickerOptions)` |
| `New` | Sub | `Public Sub New()` |
| `Accepted` | Event | `Public Event Accepted As EventHandler(Of MASFilePickerResultEventArgs)` |
| `Cancelled` | Event | `Public Event Cancelled As EventHandler` |
| `CurrentPathChanged` | Event | `Public Event CurrentPathChanged As EventHandler` |
| `ItemsChanged` | Event | `Public Event ItemsChanged As EventHandler` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `StateChanged` | Event | `Public Event StateChanged As EventHandler` |
| `AcceptSelection` | Function | `Public Function AcceptSelection() As MASFilePickerResult` |
| `ApplyOptions` | Sub | `Public Sub ApplyOptions(options As MASFilePickerOptions)` |
| `CancelSelection` | Sub | `Public Sub CancelSelection()` |
| `Create` | Function | `Public Shared Function Create() As MASFilePickerControl` |
| `FocusDefaultInput` | Function | `Public Function FocusDefaultInput() As Boolean` |
| `FocusDefault` | Function | `Public Function FocusDefault() As MASFilePickerControl` |
| `GoBack` | Sub | `Public Sub GoBack()` |
| `GoForward` | Sub | `Public Sub GoForward()` |
| `LoadRootFolders` | Function | `Public Function LoadRootFolders() As MASFilePickerControl` |
| `LoadRoots` | Sub | `Public Sub LoadRoots()` |
| `NavigateToFolder` | Function | `Public Function NavigateToFolder(path As String) As MASFilePickerControl` |
| `NavigateTo` | Sub | `Public Sub NavigateTo(path As String)` |
| `NavigateUp` | Sub | `Public Sub NavigateUp()` |
| `RefreshItems` | Sub | `Public Sub RefreshItems()` |
| `RefreshPicker` | Function | `Public Function RefreshPicker() As MASFilePickerControl` |
| `SelectFirstItem` | Function | `Public Function SelectFirstItem() As MASFilePickerControl` |
| `SelectFirst` | Sub | `Public Sub SelectFirst()` |
| `UseSelectedFileNameForSave` | Sub | `Public Sub UseSelectedFileNameForSave()` |
| `UseSelectedNameForSave` | Function | `Public Function UseSelectedNameForSave() As MASFilePickerControl` |
| `WithFileName` | Function | `Public Function WithFileName(name As String) As MASFilePickerControl` |
| `WithFilter` | Function | `Public Function WithFilter(filterText As String) As MASFilePickerControl` |
| `WithFooterText` | Function | `Public Function WithFooterText(text As String) As MASFilePickerControl` |
| `WithHiddenFiles` | Function | `Public Function WithHiddenFiles(Optional visible As Boolean = True) As MASFilePickerControl` |
| `WithInitialPath` | Function | `Public Function WithInitialPath(path As String) As MASFilePickerControl` |
| `WithLocation` | Function | `Public Function WithLocation(x As Single, y As Single) As MASFilePickerControl` |
| `WithMultiSelect` | Function | `Public Function WithMultiSelect(Optional enabled As Boolean = True) As MASFilePickerControl` |
| `WithOpenFileMode` | Function | `Public Function WithOpenFileMode() As MASFilePickerControl` |
| `WithOverwriteConfirmation` | Function | `Public Function WithOverwriteConfirmation(Optional enabled As Boolean = True) As MASFilePickerControl` |
| `WithPrimaryButtonText` | Function | `Public Function WithPrimaryButtonText(text As String) As MASFilePickerControl` |
| `WithSaveFileMode` | Function | `Public Function WithSaveFileMode() As MASFilePickerControl` |
| `WithSingleSelect` | Function | `Public Function WithSingleSelect() As MASFilePickerControl` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASFilePickerControl` |
| `WithSize` | Function | `Public Function WithSize(width As Single, height As Single) As MASFilePickerControl` |
| `WithTargetsPickerMode` | Function | `Public Function WithTargetsPickerMode() As MASFilePickerControl` |
| `WithTitle` | Function | `Public Function WithTitle(text As String) As MASFilePickerControl` |
| `WithoutHiddenFiles` | Function | `Public Function WithoutHiddenFiles() As MASFilePickerControl` |
| `AllowMultiSelect` | Property | `Public Property AllowMultiSelect As Boolean` |
| `CanAccept` | Property | `Public ReadOnly Property CanAccept As Boolean` |
| `ConfirmOverwrite` | Property | `Public Property ConfirmOverwrite As Boolean` |
| `CurrentPath` | Property | `Public ReadOnly Property CurrentPath As String` |
| `FileName` | Property | `Public Property FileName As String` |
| `Filter` | Property | `Public Property Filter As String` |
| `FooterText` | Property | `Public Property FooterText As String` |
| `InitialPath` | Property | `Public Property InitialPath As String` |
| `IsOpenFileMode` | Property | `Public ReadOnly Property IsOpenFileMode As Boolean` |
| `IsPickTargetsMode` | Property | `Public ReadOnly Property IsPickTargetsMode As Boolean` |
| `IsSaveMode` | Property | `Public ReadOnly Property IsSaveMode As Boolean` |
| `Mode` | Property | `Public Property Mode As MASFilePickerMode` |
| `PickerOptions` | Property | `Public ReadOnly Property PickerOptions As MASFilePickerOptions` |
| `PreferredFocusControl` | Property | `Public ReadOnly Property PreferredFocusControl As MASControlBase` |
| `PrimaryButtonTextOverride` | Property | `Public Property PrimaryButtonTextOverride As String` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedPaths` | Property | `Public ReadOnly Property SelectedPaths As IReadOnlyList(Of String)` |
| `SelectedPath` | Property | `Public ReadOnly Property SelectedPath As String` |
| `ShowHidden` | Property | `Public Property ShowHidden As Boolean` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASFilePickerResultEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FilePicker/Control/MASFilePickerResultEventArgs.vb:16` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed event data for File Picker Result Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Result` | Property | `Public ReadOnly Property Result As MASFilePickerResult` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASFilterBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/FilterBuilder/MASFilterBuilder.Helpers.vb:29`<br>`Component/Data/FilterBuilder/MASFilterBuilder.Interaction.vb:29`<br>`Component/Data/FilterBuilder/MASFilterBuilder.Layout.vb:29`<br>`Component/Data/FilterBuilder/MASFilterBuilder.Rendering.vb:29`<br>`Component/Data/FilterBuilder/MASFilterBuilder.vb:29` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Filter Builder component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `RulesChanged` | Event | `Public Event RulesChanged As EventHandler` |
| `SelectedRuleChanged` | Event | `Public Event SelectedRuleChanged As EventHandler` |
| `AddRule` | Function | `Public Function AddRule(rule As MASFilterRule) As MASFilterBuilder` |
| `AddRule` | Function | `Public Function AddRule(fieldName As String, filterOperator As MASFilterOperator, Optional valueText As String = Nothing) As MASFilterBuilder` |
| `ClearRules` | Function | `Public Function ClearRules() As MASFilterBuilder` |
| `Create` | Function | `Public Shared Function Create(Optional rules As IEnumerable(Of MASFilterRule) = Nothing) As MASFilterBuilder` |
| `RemoveSelectedRule` | Function | `Public Function RemoveSelectedRule() As MASFilterBuilder` |
| `SetRules` | Function | `Public Function SetRules(rules As IEnumerable(Of MASFilterRule)) As MASFilterBuilder` |
| `WithRules` | Function | `Public Function WithRules(rules As IEnumerable(Of MASFilterRule)) As MASFilterBuilder` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASFilterBuilder` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASFilterBuilder` |
| `RuleCount` | Property | `Public ReadOnly Property RuleCount As Integer` |
| `Rules` | Property | `Public ReadOnly Property Rules As IReadOnlyList(Of MASFilterRule)` |
| `SelectedRuleIndex` | Property | `Public Property SelectedRuleIndex As Integer` |
| `SelectedRule` | Property | `Public ReadOnly Property SelectedRule As MASFilterRule` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASFilterRule`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/FilterBuilder/MASFilterRule.vb:13` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides a typed model/DTO used by the Filter Rule control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(fieldName As String, filterOperator As MASFilterOperator, Optional valueText As String = Nothing, Optional isEnabled As Boolean = True)` |
| `New` | Sub | `Public Sub New()` |
| `Clone` | Function | `Public Function Clone() As MASFilterRule` |
| `Create` | Function | `Public Shared Function Create(fieldName As String, filterOperator As MASFilterOperator, Optional valueText As String = Nothing) As MASFilterRule` |
| `ToString` | Function | `Public Function ToString() As String` |
| `WithEnabled` | Function | `Public Function WithEnabled(value As Boolean) As MASFilterRule` |
| `WithOperator` | Function | `Public Function WithOperator(value As MASFilterOperator) As MASFilterRule` |
| `WithValue` | Function | `Public Function WithValue(value As String) As MASFilterRule` |
| `FieldName` | Property | `Public Property FieldName As String` |
| `FilterOperator` | Property | `Public Property FilterOperator As MASFilterOperator` |
| `IsEnabled` | Property | `Public Property IsEnabled As Boolean` |
| `ValueText` | Property | `Public Property ValueText As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASFormBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/DataForm/MASFormBuilder.vb:15` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Form Builder component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `AddDate` | Function | `Public Function AddDate(label As String, valueText As String, Optional helperText As String = "") As MASFormBuilder` |
| `AddField` | Function | `Public Function AddField(label As String, valueText As String, Optional kind As MASDataFormFieldKind = MASDataFormFieldKind.Text, Optional state As MASDataFormFieldState = MASDataFormFieldState.Normal, Optional helperText As String = "", Optional required As Boolean = False) As MASFormBuilder` |
| `AddSelection` | Function | `Public Function AddSelection(label As String, valueText As String, Optional helperText As String = "") As MASFormBuilder` |
| `AddTags` | Function | `Public Function AddTags(label As String, valueText As String, Optional helperText As String = "") As MASFormBuilder` |
| `AddText` | Function | `Public Function AddText(label As String, valueText As String, Optional required As Boolean = False, Optional helperText As String = "") As MASFormBuilder` |
| `AddToggle` | Function | `Public Function AddToggle(label As String, checked As Boolean, Optional helperText As String = "") As MASFormBuilder` |
| `ApplyTo` | Function | `Public Function ApplyTo(form As MASDataForm) As MASDataForm` |
| `Clear` | Function | `Public Function Clear() As MASFormBuilder` |
| `FieldCount` | Property | `Public ReadOnly Property FieldCount As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASImageViewer`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Media/ImageViewer/MASImageViewer.Events.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.ImageExport.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.ImageLifecycle.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.Interaction.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.Layout.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.Rendering.Footer.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.Rendering.Helpers.vb:13`<br>`Component/Media/ImageViewer/MASImageViewer.Rendering.Toolbar.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.Rendering.Viewport.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.Rendering.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.ViewState.vb:21`<br>`Component/Media/ImageViewer/MASImageViewer.vb:27` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Image Viewer component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ExportRequested` | Event | `Public Event ExportRequested As EventHandler` |
| `ImageChanged` | Event | `Public Event ImageChanged As EventHandler` |
| `ImageExported` | Event | `Public Event ImageExported As EventHandler` |
| `ViewChanged` | Event | `Public Event ViewChanged As EventHandler` |
| `ActualSize` | Function | `Public Function ActualSize() As MASImageViewer` |
| `ClearImage` | Function | `Public Function ClearImage() As MASImageViewer` |
| `CreateTransformedBitmap` | Function | `Public Function CreateTransformedBitmap() As SKBitmap` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional subtitle As String = Nothing) As MASImageViewer` |
| `ExportTransformedImage` | Function | `Public Function ExportTransformedImage(filePath As String, Optional format As MASImageExportFormat = MASImageExportFormat.Png, Optional quality As Integer = 100) As Boolean` |
| `FitToView` | Function | `Public Function FitToView() As MASImageViewer` |
| `FlipHorizontal` | Function | `Public Function FlipHorizontal() As MASImageViewer` |
| `FlipVertical` | Function | `Public Function FlipVertical() As MASImageViewer` |
| `ResetView` | Function | `Public Function ResetView() As MASImageViewer` |
| `RotateLeft` | Function | `Public Function RotateLeft() As MASImageViewer` |
| `RotateRight` | Function | `Public Function RotateRight() As MASImageViewer` |
| `SetImage` | Sub | `Public Sub SetImage(bitmap As SKBitmap, Optional title As String = Nothing, Optional subtitle As String = Nothing, Optional resetView As Boolean = True, Optional takeOwnership As Boolean = False)` |
| `WithChromeMode` | Function | `Public Function WithChromeMode(mode As MASImageViewerChromeMode) As MASImageViewer` |
| `WithFooter` | Function | `Public Function WithFooter(Optional visible As Boolean = True) As MASImageViewer` |
| `WithImage` | Function | `Public Function WithImage(bitmap As SKBitmap, Optional title As String = Nothing, Optional subtitle As String = Nothing, Optional takeOwnership As Boolean = False) As MASImageViewer` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASImageViewer` |
| `ZoomIn` | Function | `Public Function ZoomIn() As MASImageViewer` |
| `ZoomOut` | Function | `Public Function ZoomOut() As MASImageViewer` |
| `ChromeMode` | Property | `Public Property ChromeMode As MASImageViewerChromeMode` |
| `FlippedHorizontal` | Property | `Public Property FlippedHorizontal As Boolean` |
| `FlippedVertical` | Property | `Public Property FlippedVertical As Boolean` |
| `HasImage` | Property | `Public ReadOnly Property HasImage As Boolean` |
| `ImageHeight` | Property | `Public ReadOnly Property ImageHeight As Integer` |
| `ImageWidth` | Property | `Public ReadOnly Property ImageWidth As Integer` |
| `RotationDegrees` | Property | `Public Property RotationDegrees As Integer` |
| `ShowFooter` | Property | `Public Property ShowFooter As Boolean` |
| `Subtitle` | Property | `Public Property Subtitle As String` |
| `Title` | Property | `Public Property Title As String` |
| `Zoom` | Property | `Public Property Zoom As Single` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASInputBoxSkiaBase`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.Composition.vb:12`<br>`MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.Disposal.vb:6`<br>`MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.Focus.vb:9`<br>`MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.Input.vb:14`<br>`MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.PublicAPI.vb:12`<br>`MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.Rendering.vb:16`<br>`MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.TextLayout.vb:16`<br>`MASSystem/Interaction/TextInput/Base/MASInputBoxSkiaBase.vb:22` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Input Box Skia Base component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AppendText` | Sub | `Public Sub AppendText(value As String)` |
| `ClearValidation` | Sub | `Public Sub ClearValidation()` |
| `Clear` | Sub | `Public Sub Clear()` |
| `FocusDefaultInput` | Function | `Public Function FocusDefaultInput() As Boolean` |
| `FocusText` | Sub | `Public Sub FocusText()` |
| `ProcessWin32ImeMessage` | Function | `Public Function ProcessWin32ImeMessage(hwnd As IntPtr, message As Integer, wParam As IntPtr, lParam As IntPtr) As Boolean` |
| `SelectAll` | Sub | `Public Sub SelectAll()` |
| `SetSelection` | Sub | `Public Sub SetSelection(start As Integer, length As Integer)` |
| `SetTextFontFamilies` | Sub | `Public Sub SetTextFontFamilies(defaultFamily As String, Optional latinFamily As String = Nothing, Optional arabicFamily As String = Nothing, Optional monospaceFamily As String = Nothing, Optional sizeDip As Single = 0.0)` |
| `SetTextFont` | Sub | `Public Sub SetTextFont(family As String, Optional sizeDip As Single = 0.0)` |
| `SetValidation` | Sub | `Public Sub SetValidation(state As MASTextValidationState, Optional message As String = Nothing)` |
| `UseArabicClassicFontProfile` | Sub | `Public Sub UseArabicClassicFontProfile(Optional sizeDip As Single = 0.0)` |
| `UseArabicFriendlyFontProfile` | Sub | `Public Sub UseArabicFriendlyFontProfile()` |
| `UseArabicModernFontProfile` | Sub | `Public Sub UseArabicModernFontProfile(Optional sizeDip As Single = 0.0)` |
| `UseArabicReadingFontProfile` | Sub | `Public Sub UseArabicReadingFontProfile(Optional sizeDip As Single = 0.0)` |
| `UseCodeFontProfile` | Sub | `Public Sub UseCodeFontProfile()` |
| `UseDefaultFontProfile` | Sub | `Public Sub UseDefaultFontProfile()` |
| `UseLatinCodeFontProfile` | Sub | `Public Sub UseLatinCodeFontProfile(Optional sizeDip As Single = 0.0)` |
| `UseLatinModernFontProfile` | Sub | `Public Sub UseLatinModernFontProfile(Optional sizeDip As Single = 0.0)` |
| `UseLatinSerifFontProfile` | Sub | `Public Sub UseLatinSerifFontProfile(Optional sizeDip As Single = 0.0)` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASInputBoxSkiaBase` |
| `ArabicFontFamily` | Property | `Public Property ArabicFontFamily As String` |
| `CaretIndex` | Property | `Public ReadOnly Property CaretIndex As Integer` |
| `LatinFontFamily` | Property | `Public Property LatinFontFamily As String` |
| `MaxLength` | Property | `Public Property MaxLength As Integer` |
| `MonospaceFontFamily` | Property | `Public Property MonospaceFontFamily As String` |
| `MultilineWordWrap` | Property | `Public Property MultilineWordWrap As Boolean` |
| `Multiline` | Property | `Public Property Multiline As Boolean` |
| `PasswordChar` | Property | `Public Property PasswordChar As Char` |
| `Placeholder` | Property | `Public Property Placeholder As String` |
| `PreferMonospaceFont` | Property | `Public Property PreferMonospaceFont As Boolean` |
| `PreferredFocusControl` | Property | `Public ReadOnly Property PreferredFocusControl As MASControlBase` |
| `ReadOnly` | Property | `Public Property ReadOnly As Boolean` |
| `SelectedText` | Property | `Public ReadOnly Property SelectedText As String` |
| `SelectionLength` | Property | `Public Property SelectionLength As Integer` |
| `SelectionStart` | Property | `Public Property SelectionStart As Integer` |
| `ShowValidationIndicator` | Property | `Public Property ShowValidationIndicator As Boolean` |
| `SyntaxHighlightingEnabled` | Property | `Public Property SyntaxHighlightingEnabled As Boolean` |
| `TextCrispRendering` | Property | `Public Property TextCrispRendering As Boolean` |
| `TextFontFamily` | Property | `Public Property TextFontFamily As String` |
| `TextFontSizeDip` | Property | `Public Property TextFontSizeDip As Single` |
| `Text` | Property | `Public Property Text As String` |
| `UseSystemPasswordChar` | Property | `Public Property UseSystemPasswordChar As Boolean` |
| `ValidationMessage` | Property | `Public Property ValidationMessage As String` |
| `ValidationState` | Property | `Public Property ValidationState As MASTextValidationState` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASKanbanBoard`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/KanbanBoard/MASKanbanBoard.BoardWindow.vb:109`<br>`Component/Data/KanbanBoard/MASKanbanBoard.DataSource.vb:15`<br>`Component/Data/KanbanBoard/MASKanbanBoard.DropPolicy.vb:53`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Events.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Geometry.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Governance.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Interaction.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.ItemModel.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Layout.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Motion.vb:13`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Persistence.vb:92`<br>`Component/Data/KanbanBoard/MASKanbanBoard.Rendering.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.ViewState.vb:22`<br>`Component/Data/KanbanBoard/MASKanbanBoard.vb:22` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Kanban Board component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `BoardChanged` | Event | `Public Event BoardChanged As EventHandler` |
| `CardMoved` | Event | `Public Event CardMoved As EventHandler` |
| `SelectedCardChanged` | Event | `Public Event SelectedCardChanged As EventHandler` |
| `AddCard` | Function | `Public Function AddCard(columnKey As String, cardKey As String, title As String, Optional detail As String = Nothing, Optional badgeText As String = Nothing) As MASKanbanBoard` |
| `AddColumn` | Function | `Public Function AddColumn(columnKey As String, title As String) As MASKanbanBoard` |
| `ClearBoard` | Function | `Public Function ClearBoard() As MASKanbanBoard` |
| `CreateBoardSnapshot` | Function | `Public Function CreateBoardSnapshot() As MASKanbanBoardSnapshot` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASKanbanBoard` |
| `GetCardKeys` | Function | `Public Function GetCardKeys(columnKey As String) As IReadOnlyList(Of String)` |
| `GetColumnKeys` | Function | `Public Function GetColumnKeys() As IReadOnlyList(Of String)` |
| `MoveCardToIndex` | Function | `Public Function MoveCardToIndex(cardKey As String, targetColumnKey As String, targetCardIndex As Integer) As Boolean` |
| `MoveCard` | Function | `Public Function MoveCard(cardKey As String, targetColumnKey As String) As Boolean` |
| `MoveSelectedCardBy` | Function | `Public Function MoveSelectedCardBy(delta As Integer) As Boolean` |
| `MoveSelectedCardToColumn` | Function | `Public Function MoveSelectedCardToColumn(targetColumnKey As String) As Boolean` |
| `ResetBoardViewport` | Function | `Public Function ResetBoardViewport() As MASKanbanBoard` |
| `RestoreBoardSnapshot` | Function | `Public Function RestoreBoardSnapshot(snapshot As MASKanbanBoardSnapshot) As Boolean` |
| `SelectCard` | Function | `Public Function SelectCard(cardKey As String) As Boolean` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASKanbanBoard` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASKanbanBoard` |
| `CardCount` | Property | `Public ReadOnly Property CardCount As Integer` |
| `ColumnCount` | Property | `Public ReadOnly Property ColumnCount As Integer` |
| `SelectedCardKey` | Property | `Public ReadOnly Property SelectedCardKey As String` |
| `SelectedColumnKey` | Property | `Public ReadOnly Property SelectedColumnKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASKanbanBoardSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Data/KanbanBoard/MASKanbanBoard.Persistence.vb:17` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Represents a captured state snapshot for the Kanban Board Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(version As Integer, title As String, selectedColumnKey As String, selectedCardKey As String, leftColumnIndex As Integer, columns As IEnumerable(Of MASKanbanColumnSnapshot))` |
| `Columns` | Property | `Public ReadOnly Property Columns As IReadOnlyList(Of MASKanbanColumnSnapshot)` |
| `LeftColumnIndex` | Property | `Public ReadOnly Property LeftColumnIndex As Integer` |
| `SelectedCardKey` | Property | `Public ReadOnly Property SelectedCardKey As String` |
| `SelectedColumnKey` | Property | `Public ReadOnly Property SelectedColumnKey As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |
| `Version` | Property | `Public ReadOnly Property Version As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASKanbanCardSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Data/KanbanBoard/MASKanbanBoard.Persistence.vb:75` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Represents a captured state snapshot for the Kanban Card Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(key As String, title As String, detail As String, badgeText As String)` |
| `BadgeText` | Property | `Public ReadOnly Property BadgeText As String` |
| `Detail` | Property | `Public ReadOnly Property Detail As String` |
| `Key` | Property | `Public ReadOnly Property Key As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASKanbanColumnSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Data/KanbanBoard/MASKanbanBoard.Persistence.vb:49` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Represents a captured state snapshot for the Kanban Column Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(key As String, title As String, topCardIndex As Integer, cards As IEnumerable(Of MASKanbanCardSnapshot))` |
| `Cards` | Property | `Public ReadOnly Property Cards As IReadOnlyList(Of MASKanbanCardSnapshot)` |
| `Key` | Property | `Public ReadOnly Property Key As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |
| `TopCardIndex` | Property | `Public ReadOnly Property TopCardIndex As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASListBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListBox/MASListBox.Api.vb:25`<br>`Component/Navigation/List/ListBox/MASListBox.Helpers.vb:26`<br>`Component/Navigation/List/ListBox/MASListBox.Input.vb:25`<br>`Component/Navigation/List/ListBox/MASListBox.Lifetime.vb:26`<br>`Component/Navigation/List/ListBox/MASListBox.Measurement.vb:25`<br>`Component/Navigation/List/ListBox/MASListBox.Rendering.vb:26`<br>`Component/Navigation/List/ListBox/MASListBox.vb:30` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced List Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddItems` | Sub | `Public Sub AddItems(items As IEnumerable(Of String))` |
| `AddItem` | Sub | `Public Sub AddItem(text As String)` |
| `AddRange` | Function | `Public Function AddRange(items As IEnumerable(Of String)) As MASListBox` |
| `Add` | Function | `Public Function Add(text As String) As MASListBox` |
| `ClearItems` | Sub | `Public Sub ClearItems()` |
| `ClearSelection` | Function | `Public Function ClearSelection() As MASListBox` |
| `Clear` | Function | `Public Function Clear() As MASListBox` |
| `Create` | Function | `Public Shared Function Create() As MASListBox` |
| `RemoveAt` | Function | `Public Function RemoveAt(index As Integer) As Boolean` |
| `SelectFirstItem` | Function | `Public Function SelectFirstItem() As MASListBox` |
| `SelectFirst` | Sub | `Public Sub SelectFirst()` |
| `SelectIndex` | Function | `Public Function SelectIndex(index As Integer) As MASListBox` |
| `SelectNone` | Sub | `Public Sub SelectNone()` |
| `WithItems` | Function | `Public Function WithItems(items As IEnumerable(Of String)) As MASListBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASListBox` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `Items` | Property | `Public ReadOnly Property Items As IReadOnlyList(Of String)` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `SelectedItem` | Property | `Public ReadOnly Property SelectedItem As String` |
| `SelectedText` | Property | `Public ReadOnly Property SelectedText As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASListView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Core/MASListView.Api.vb:27`<br>`Component/Navigation/List/ListView/Core/MASListView.Fluent.vb:27`<br>`Component/Navigation/List/ListView/Core/MASListView.Helpers.vb:28`<br>`Component/Navigation/List/ListView/Core/MASListView.IconResolverLifecycle.vb:27`<br>`Component/Navigation/List/ListView/Core/MASListView.Lifetime.vb:28`<br>`Component/Navigation/List/ListView/Core/MASListView.Measurement.vb:27`<br>`Component/Navigation/List/ListView/Core/MASListView.vb:32`<br>`Component/Navigation/List/ListView/InlineRename/MASListView.InlineRename.Commit.vb:17`<br>`Component/Navigation/List/ListView/InlineRename/MASListView.InlineRename.Editing.vb:17`<br>`Component/Navigation/List/ListView/InlineRename/MASListView.InlineRename.Input.vb:17`<br>`Component/Navigation/List/ListView/InlineRename/MASListView.InlineRename.Rects.vb:17`<br>`Component/Navigation/List/ListView/InlineRename/MASListView.InlineRename.Rendering.vb:17`<br>`Component/Navigation/List/ListView/InlineRename/MASListView.InlineRename.vb:17`<br>`Component/Navigation/List/ListView/Input/MASListView.Input.vb:12`<br>`Component/Navigation/List/ListView/Layout/MASListView.Layout.vb:14`<br>`Component/Navigation/List/ListView/Rendering/MASListView.Rendering.Headers.vb:19`<br>`Component/Navigation/List/ListView/Rendering/MASListView.Rendering.Icons.vb:19`<br>`Component/Navigation/List/ListView/Rendering/MASListView.Rendering.RowColors.vb:19`<br>`Component/Navigation/List/ListView/Rendering/MASListView.Rendering.Rows.vb:20`<br>`Component/Navigation/List/ListView/Rendering/MASListView.Rendering.Tiles.vb:20`<br>`Component/Navigation/List/ListView/Rendering/MASListView.Rendering.Virtualization.vb:19`<br>`Component/Navigation/List/ListView/Rendering/MASListView.Rendering.vb:20`<br>`Component/Navigation/List/ListView/Selection/MASListView.Selection.vb:17` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** An advanced virtualized list/table component.

**When to use it.** Use it for large or structured lists after reviewing product-control recipes and boundary notes.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ColumnHeaderClicked` | Event | `Public Event ColumnHeaderClicked As EventHandler(Of MASListViewColumnClickEventArgs)` |
| `EmptySpaceContextMenuRequested` | Event | `Public Event EmptySpaceContextMenuRequested As EventHandler(Of MASListViewEmptySpaceContextMenuRequestedEventArgs)` |
| `InlineRenameCommitted` | Event | `Public Event InlineRenameCommitted As EventHandler(Of MASListViewInlineRenameCommittedEventArgs)` |
| `ItemActivated` | Event | `Public Event ItemActivated As EventHandler` |
| `ItemContextMenuRequested` | Event | `Public Event ItemContextMenuRequested As EventHandler(Of MASListViewItemContextMenuRequestedEventArgs)` |
| `SelectedIndexChanged` | Event | `Public Event SelectedIndexChanged As EventHandler` |
| `AddColumnFluent` | Function | `Public Function AddColumnFluent(column As MASListViewColumn) As MASListView` |
| `AddColumnFluent` | Function | `Public Function AddColumnFluent(text As String, widthDip As Single) As MASListView` |
| `AddColumn` | Function | `Public Function AddColumn(text As String, widthDip As Single) As MASListViewColumn` |
| `AddColumn` | Sub | `Public Sub AddColumn(column As MASListViewColumn)` |
| `AddGroupHeader` | Function | `Public Function AddGroupHeader(text As String) As MASListView` |
| `AddItem` | Function | `Public Function AddItem(text As String) As MASListViewItem` |
| `AddItem` | Sub | `Public Sub AddItem(item As MASListViewItem)` |
| `AddRange` | Function | `Public Function AddRange(items As IEnumerable(Of MASListViewItem)) As MASListView` |
| `AddTextRange` | Function | `Public Function AddTextRange(items As IEnumerable(Of String)) As MASListView` |
| `Add` | Function | `Public Function Add(item As MASListViewItem) As MASListView` |
| `Add` | Function | `Public Function Add(text As String) As MASListView` |
| `BeginInlineRename` | Function | `Public Function BeginInlineRename(item As MASListViewItem, Optional selectNameWithoutExtension As Boolean = True) As Boolean` |
| `BeginInlineRename` | Function | `Public Function BeginInlineRename(itemIndex As Integer, Optional selectNameWithoutExtension As Boolean = True) As Boolean` |
| `CancelInlineRename` | Sub | `Public Sub CancelInlineRename()` |
| `ClearColumnsFluent` | Function | `Public Function ClearColumnsFluent() As MASListView` |
| `ClearColumns` | Sub | `Public Sub ClearColumns()` |
| `ClearItems` | Sub | `Public Sub ClearItems()` |
| `ClearSelection` | Function | `Public Function ClearSelection() As MASListView` |
| `ClearSortState` | Sub | `Public Sub ClearSortState()` |
| `Clear` | Function | `Public Function Clear() As MASListView` |
| `Create` | Function | `Public Shared Function Create() As MASListView` |
| `EmbeddedChrome` | Function | `Public Function EmbeddedChrome() As MASListView` |
| `IndexOfItem` | Function | `Public Function IndexOfItem(item As MASListViewItem) As Integer` |
| `SelectFirstItem` | Function | `Public Function SelectFirstItem() As MASListView` |
| `SelectIndex` | Function | `Public Function SelectIndex(index As Integer) As MASListView` |
| `SetIconResolver` | Sub | `Public Sub SetIconResolver(resolver As IMASIconResolver, ownsResolver As Boolean)` |
| `SetItemsFrom` | Sub | `Public Sub SetItemsFrom(items As IEnumerable(Of MASListViewItem))` |
| `SetSortState` | Sub | `Public Sub SetSortState(columnIndex As Integer, direction As MASListViewSortDirection)` |
| `StandaloneChrome` | Function | `Public Function StandaloneChrome() As MASListView` |
| `TransparentChrome` | Function | `Public Function TransparentChrome() As MASListView` |
| `WithChrome` | Function | `Public Function WithChrome(mode As MASListViewChromeMode) As MASListView` |
| `WithColumns` | Function | `Public Function WithColumns(columns As IEnumerable(Of MASListViewColumn)) As MASListView` |
| `WithDetailsView` | Function | `Public Function WithDetailsView() As MASListView` |
| `WithHeaderHeight` | Function | `Public Function WithHeaderHeight(valueDip As Single) As MASListView` |
| `WithIconResolver` | Function | `Public Function WithIconResolver(resolver As IMASIconResolver, Optional ownsResolver As Boolean = False) As MASListView` |
| `WithIconSizeMode` | Function | `Public Function WithIconSizeMode(mode As MASListTreeIconSizeMode) As MASListView` |
| `WithItemIconSize` | Function | `Public Function WithItemIconSize(valueDip As Single) As MASListView` |
| `WithItems` | Function | `Public Function WithItems(items As IEnumerable(Of MASListViewItem)) As MASListView` |
| `WithLargeIconsView` | Function | `Public Function WithLargeIconsView() As MASListView` |
| `WithListView` | Function | `Public Function WithListView() As MASListView` |
| `WithRowHeight` | Function | `Public Function WithRowHeight(valueDip As Single) As MASListView` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASListView` |
| `WithSort` | Function | `Public Function WithSort(columnIndex As Integer, direction As MASListViewSortDirection) As MASListView` |
| `WithTextItems` | Function | `Public Function WithTextItems(items As IEnumerable(Of String)) As MASListView` |
| `WithTilesView` | Function | `Public Function WithTilesView() As MASListView` |
| `WithViewMode` | Function | `Public Function WithViewMode(mode As MASListViewMode) As MASListView` |
| `WithoutSort` | Function | `Public Function WithoutSort() As MASListView` |
| `ChromeMode` | Property | `Public Property ChromeMode As MASListViewChromeMode` |
| `Columns` | Property | `Public ReadOnly Property Columns As IReadOnlyList(Of MASListViewColumn)` |
| `HeaderHeightDip` | Property | `Public Property HeaderHeightDip As Single` |
| `IconResolver` | Property | `Public Property IconResolver As IMASIconResolver` |
| `IconSizeMode` | Property | `Public Property IconSizeMode As MASListTreeIconSizeMode` |
| `InlineRenameIndex` | Property | `Public ReadOnly Property InlineRenameIndex As Integer` |
| `IsInlineRenameActive` | Property | `Public ReadOnly Property IsInlineRenameActive As Boolean` |
| `ItemIconSizeDip` | Property | `Public Property ItemIconSizeDip As Single` |
| `Items` | Property | `Public ReadOnly Property Items As IReadOnlyList(Of MASListViewItem)` |
| `RowHeightDip` | Property | `Public Property RowHeightDip As Single` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `SelectedIndices` | Property | `Public ReadOnly Property SelectedIndices As IReadOnlyList(Of Integer)` |
| `SelectedItems` | Property | `Public ReadOnly Property SelectedItems As IReadOnlyList(Of MASListViewItem)` |
| `SelectedItem` | Property | `Public ReadOnly Property SelectedItem As MASListViewItem` |
| `SortColumnIndex` | Property | `Public ReadOnly Property SortColumnIndex As Integer` |
| `SortDirection` | Property | `Public ReadOnly Property SortDirection As MASListViewSortDirection` |
| `ViewMode` | Property | `Public Property ViewMode As MASListViewMode` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASListViewColumn`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Core/MASListViewColumn.vb:17` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides a typed model/DTO used by the List View Column control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String, widthDip As Single)` |
| `New` | Sub | `Public Sub New()` |
| `FillWeight` | Property | `Public Property FillWeight As Single` |
| `MinWidthDip` | Property | `Public Property MinWidthDip As Single` |
| `Sortable` | Property | `Public Property Sortable As Boolean` |
| `TextAlign` | Property | `Public Property TextAlign As MASListViewColumnTextAlign` |
| `Text` | Property | `Public Property Text As String` |
| `Visible` | Property | `Public Property Visible As Boolean` |
| `WidthDip` | Property | `Public Property WidthDip As Single` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASListViewColumnClickEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Columns/MASListViewColumnClickEventArgs.vb:8` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed event data for List View Column Click Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ColumnIndex` | Property | `Public ReadOnly Property ColumnIndex As Integer` |
| `Direction` | Property | `Public ReadOnly Property Direction As MASListViewSortDirection` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASListViewEmptySpaceContextMenuRequestedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Input/MASListViewEmptySpaceContextMenuRequestedEventArgs.vb:14` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Carries typed event data for List View Empty Space Context Menu Requested Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AnchorRectPx` | Property | `Public ReadOnly Property AnchorRectPx As SKRect` |
| `PointPx` | Property | `Public ReadOnly Property PointPx As SKPoint` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASListViewInlineRenameCommittedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/InlineRename/MASListViewInlineRenameCommittedEventArgs.vb:12` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed event data for List View Inline Rename Committed Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Cancel` | Property | `Public Property Cancel As Boolean` |
| `ErrorMessage` | Property | `Public Property ErrorMessage As String` |
| `ItemIndex` | Property | `Public ReadOnly Property ItemIndex As Integer` |
| `Item` | Property | `Public ReadOnly Property Item As MASListViewItem` |
| `NewText` | Property | `Public ReadOnly Property NewText As String` |
| `OriginalText` | Property | `Public ReadOnly Property OriginalText As String` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASListViewItem`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Core/MASListViewItem.vb:19` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides a typed model/DTO used by the List View Item control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `AsFile` | Function | `Public Function AsFile() As MASListViewItem` |
| `AsFolder` | Function | `Public Function AsFolder(Optional value As Boolean = True) As MASListViewItem` |
| `Create` | Function | `Public Shared Function Create(text As String) As MASListViewItem` |
| `DisabledItem` | Function | `Public Function DisabledItem() As MASListViewItem` |
| `EnabledItem` | Function | `Public Function EnabledItem(Optional value As Boolean = True) As MASListViewItem` |
| `GetCellText` | Function | `Public Function GetCellText(columnIndex As Integer) As String` |
| `GroupHeader` | Function | `Public Shared Function GroupHeader(text As String) As MASListViewItem` |
| `SetSubItems` | Sub | `Public Sub SetSubItems(values As IEnumerable(Of String))` |
| `ToString` | Function | `Public Function ToString() As String` |
| `WithSubItems` | Function | `Public Function WithSubItems(values As IEnumerable(Of String)) As MASListViewItem` |
| `WithTag` | Function | `Public Function WithTag(value As Object) As MASListViewItem` |
| `WithText` | Function | `Public Function WithText(text As String) As MASListViewItem` |
| `Enabled` | Property | `Public Property Enabled As Boolean` |
| `IsFolder` | Property | `Public Property IsFolder As Boolean` |
| `IsGroupHeader` | Property | `Public ReadOnly Property IsGroupHeader As Boolean` |
| `IsSelectable` | Property | `Public ReadOnly Property IsSelectable As Boolean` |
| `Kind` | Property | `Public Property Kind As MASListViewItemKind` |
| `SubItems` | Property | `Public ReadOnly Property SubItems As IReadOnlyList(Of String)` |
| `Tag` | Property | `Public Property Tag As Object` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASListViewItemContextMenuRequestedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Input/MASListViewItemContextMenuRequestedEventArgs.vb:14` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Carries typed event data for List View Item Context Menu Requested Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AnchorRectPx` | Property | `Public ReadOnly Property AnchorRectPx As SKRect` |
| `ItemIndex` | Property | `Public ReadOnly Property ItemIndex As Integer` |
| `Item` | Property | `Public ReadOnly Property Item As MASListViewItem` |
| `PointPx` | Property | `Public ReadOnly Property PointPx As SKPoint` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASMasterDetailItemSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Data/MasterDetailView/MASMasterDetailView.Persistence.vb:47` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Represents a captured state snapshot for the Master Detail Item Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(key As String, title As String, subtitle As String, detailTitle As String, detailText As String, badgeText As String)` |
| `BadgeText` | Property | `Public ReadOnly Property BadgeText As String` |
| `DetailText` | Property | `Public ReadOnly Property DetailText As String` |
| `DetailTitle` | Property | `Public ReadOnly Property DetailTitle As String` |
| `Key` | Property | `Public ReadOnly Property Key As String` |
| `Subtitle` | Property | `Public ReadOnly Property Subtitle As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASMasterDetailView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/MasterDetailView/MASMasterDetailView.DataSource.vb:15`<br>`Component/Data/MasterDetailView/MASMasterDetailView.EmptyError.vb:71`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Events.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Geometry.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Governance.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Hosting.vb:11`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Interaction.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.ItemModel.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.ItemWindow.vb:71`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Layout.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Motion.vb:13`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Persistence.vb:70`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Rendering.Detail.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Rendering.Master.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Rendering.Surface.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.Rendering.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.RoutingBoundary.vb:6`<br>`Component/Data/MasterDetailView/MASMasterDetailView.ViewState.vb:21`<br>`Component/Data/MasterDetailView/MASMasterDetailView.vb:28` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Master Detail View component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `MasterDetailChanged` | Event | `Public Event MasterDetailChanged As EventHandler` |
| `SelectedItemChanged` | Event | `Public Event SelectedItemChanged As EventHandler` |
| `AddItem` | Function | `Public Function AddItem(itemKey As String, title As String, Optional subtitle As String = Nothing, Optional detailTitle As String = Nothing, Optional detailText As String = Nothing, Optional badgeText As String = Nothing) As MASMasterDetailView` |
| `ClearItems` | Function | `Public Function ClearItems() As MASMasterDetailView` |
| `CreateViewSnapshot` | Function | `Public Function CreateViewSnapshot() As MASMasterDetailViewSnapshot` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASMasterDetailView` |
| `GetItemKeys` | Function | `Public Function GetItemKeys() As IReadOnlyList(Of String)` |
| `MoveNext` | Function | `Public Function MoveNext() As MASMasterDetailView` |
| `MovePrevious` | Function | `Public Function MovePrevious() As MASMasterDetailView` |
| `ResetMasterViewport` | Function | `Public Function ResetMasterViewport() As MASMasterDetailView` |
| `RestoreViewSnapshot` | Function | `Public Function RestoreViewSnapshot(snapshot As MASMasterDetailViewSnapshot) As Boolean` |
| `SelectItem` | Function | `Public Function SelectItem(itemKey As String) As Boolean` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASMasterDetailView` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASMasterDetailView` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedItemKey` | Property | `Public ReadOnly Property SelectedItemKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASMasterDetailViewSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Data/MasterDetailView/MASMasterDetailView.Persistence.vb:17` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Represents a captured state snapshot for the Master Detail View Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(version As Integer, title As String, selectedItemKey As String, topIndex As Integer, items As IEnumerable(Of MASMasterDetailItemSnapshot))` |
| `Items` | Property | `Public ReadOnly Property Items As IReadOnlyList(Of MASMasterDetailItemSnapshot)` |
| `SelectedItemKey` | Property | `Public ReadOnly Property SelectedItemKey As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |
| `TopIndex` | Property | `Public ReadOnly Property TopIndex As Integer` |
| `Version` | Property | `Public ReadOnly Property Version As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASMenuBar`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Menus/MenuBar/MASMenuBar.vb:28` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Menu Bar component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectedIndexChanged` | Event | `Public Event SelectedIndexChanged As EventHandler` |
| `AddAction` | Function | `Public Function AddAction(menuText As String, itemText As String, commandId As String, Optional handler As Action = Nothing, Optional shortcutText As String = "", Optional enabled As Boolean = True, Optional intent As MASDropDownMenuItemIntent = MASDropDownMenuItemIntent.Default) As MASMenuBar` |
| `AddMenu` | Function | `Public Function AddMenu(text As String, configure As Action(Of MASDropDownMenuBuilder), Optional commandHandler As Action(Of String) = Nothing) As MASMenuBar` |
| `ClearMenus` | Function | `Public Function ClearMenus() As MASMenuBar` |
| `Create` | Function | `Public Shared Function Create() As MASMenuBar` |
| `GetMenuText` | Function | `Public Function GetMenuText(index As Integer) As String` |
| `OnCommand` | Function | `Public Function OnCommand(handler As Action(Of String)) As MASMenuBar` |
| `ShowSelectedMenu` | Sub | `Public Sub ShowSelectedMenu()` |
| `WithMenu` | Function | `Public Function WithMenu(text As String, configure As Action(Of MASDropDownMenuBuilder), Optional commandHandler As Action(Of String) = Nothing) As MASMenuBar` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASMenuBar` |
| `MenuCount` | Property | `Public ReadOnly Property MenuCount As Integer` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASMetricCard`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/MetricCard/MASMetricCard.vb:26` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the advanced Metric Card component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ClearTrendSamples` | Function | `Public Function ClearTrendSamples() As MASMetricCard` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional valueText As String = Nothing) As MASMetricCard` |
| `SetMetricValue` | Function | `Public Function SetMetricValue(value As Double, Optional suffix As String = Nothing) As MASMetricCard` |
| `SetMetric` | Function | `Public Function SetMetric(title As String, valueText As String, Optional subtitle As String = Nothing, Optional trendText As String = Nothing, Optional tone As MASToastTone = MASToastTone.Info) As MASMetricCard` |
| `SetTrendSamples` | Function | `Public Function SetTrendSamples(samples As IEnumerable(Of Double)) As MASMetricCard` |
| `WithCompact` | Function | `Public Function WithCompact(value As Boolean) As MASMetricCard` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASMetricCard` |
| `WithSubtitle` | Function | `Public Function WithSubtitle(value As String) As MASMetricCard` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASMetricCard` |
| `WithTone` | Function | `Public Function WithTone(value As MASToastTone) As MASMetricCard` |
| `WithTrendVisible` | Function | `Public Function WithTrendVisible(value As Boolean) As MASMetricCard` |
| `WithTrend` | Function | `Public Function WithTrend(value As String, Optional tone As MASToastTone = MASToastTone.Info) As MASMetricCard` |
| `WithValueText` | Function | `Public Function WithValueText(value As String) As MASMetricCard` |
| `HasTrendSamples` | Property | `Public ReadOnly Property HasTrendSamples As Boolean` |
| `IsCompact` | Property | `Public Property IsCompact As Boolean` |
| `ShowTrend` | Property | `Public Property ShowTrend As Boolean` |
| `Subtitle` | Property | `Public Property Subtitle As String` |
| `Title` | Property | `Public Property Title As String` |
| `Tone` | Property | `Public Property Tone As MASToastTone` |
| `TrendText` | Property | `Public Property TrendText As String` |
| `ValueText` | Property | `Public Property ValueText As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASMultilineTextBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TextBox/Controls/MASTextBox/MASMultilineTextBox.vb:12` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Multiline Text Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `AsEditable` | Function | `Public Function AsEditable() As MASMultilineTextBox` |
| `AsReadOnly` | Function | `Public Function AsReadOnly() As MASMultilineTextBox` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASMultilineTextBox` |
| `FocusInput` | Function | `Public Function FocusInput() As MASMultilineTextBox` |
| `WithMaxLength` | Function | `Public Function WithMaxLength(value As Integer) As MASMultilineTextBox` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASMultilineTextBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASMultilineTextBox` |
| `WithText` | Function | `Public Function WithText(value As String) As MASMultilineTextBox` |
| `WithValidation` | Function | `Public Function WithValidation(state As MASTextValidationState, Optional message As String = Nothing) As MASMultilineTextBox` |
| `WithWordWrap` | Function | `Public Function WithWordWrap(value As Boolean) As MASMultilineTextBox` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASNavigationRail`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/NavigationRail/MASNavigationRail.vb:29` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Navigation Rail component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `NavigationRailChanged` | Event | `Public Event NavigationRailChanged As EventHandler` |
| `SelectedItemChanged` | Event | `Public Event SelectedItemChanged As EventHandler` |
| `AddItem` | Function | `Public Function AddItem(itemKey As String, label As String, Optional badgeText As String = Nothing, Optional glyphText As String = Nothing) As MASNavigationRail` |
| `ClearItems` | Function | `Public Function ClearItems() As MASNavigationRail` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASNavigationRail` |
| `GetItemKeys` | Function | `Public Function GetItemKeys() As IReadOnlyList(Of String)` |
| `MoveNext` | Function | `Public Function MoveNext() As MASNavigationRail` |
| `MovePrevious` | Function | `Public Function MovePrevious() As MASNavigationRail` |
| `SelectItem` | Function | `Public Function SelectItem(itemKey As String) As Boolean` |
| `WithCompact` | Function | `Public Function WithCompact(value As Boolean) As MASNavigationRail` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASNavigationRail` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASNavigationRail` |
| `IsCompact` | Property | `Public Property IsCompact As Boolean` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedItemKey` | Property | `Public ReadOnly Property SelectedItemKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASNumericTextBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TextBox/Controls/MASNumericTextBox/MASNumericTextBox.vb:16` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Numeric Text Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(value As Double)` |
| `New` | Sub | `Public Sub New(value As Integer)` |
| `New` | Sub | `Public Sub New()` |
| `AllowDecimalNumbers` | Function | `Public Function AllowDecimalNumbers() As MASNumericTextBox` |
| `AllowNegativeNumbers` | Function | `Public Function AllowNegativeNumbers() As MASNumericTextBox` |
| `AllowOnlyInteger` | Function | `Public Function AllowOnlyInteger() As MASNumericTextBox` |
| `AsEditable` | Function | `Public Function AsEditable() As MASNumericTextBox` |
| `AsReadOnly` | Function | `Public Function AsReadOnly() As MASNumericTextBox` |
| `ClearValue` | Function | `Public Function ClearValue() As MASNumericTextBox` |
| `Create` | Function | `Public Shared Function Create() As MASNumericTextBox` |
| `DisallowNegativeNumbers` | Function | `Public Function DisallowNegativeNumbers() As MASNumericTextBox` |
| `FocusInput` | Function | `Public Function FocusInput() As MASNumericTextBox` |
| `SelectTextAll` | Function | `Public Function SelectTextAll() As MASNumericTextBox` |
| `SetDoubleValue` | Sub | `Public Sub SetDoubleValue(value As Double)` |
| `SetIntegerValue` | Sub | `Public Sub SetIntegerValue(value As Integer)` |
| `ShowValidation` | Function | `Public Function ShowValidation(value As Boolean) As MASNumericTextBox` |
| `WithDecimalSeparator` | Function | `Public Function WithDecimalSeparator(value As Char) As MASNumericTextBox` |
| `WithDoubleValue` | Function | `Public Function WithDoubleValue(value As Double) As MASNumericTextBox` |
| `WithIntegerValue` | Function | `Public Function WithIntegerValue(value As Integer) As MASNumericTextBox` |
| `WithMaxLength` | Function | `Public Function WithMaxLength(value As Integer) As MASNumericTextBox` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASNumericTextBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASNumericTextBox` |
| `WithValidation` | Function | `Public Function WithValidation(state As MASTextValidationState, Optional message As String = Nothing) As MASNumericTextBox` |
| `WithoutValidation` | Function | `Public Function WithoutValidation() As MASNumericTextBox` |
| `AllowDecimal` | Property | `Public Property AllowDecimal As Boolean` |
| `AllowNegative` | Property | `Public Property AllowNegative As Boolean` |
| `DecimalSeparator` | Property | `Public Property DecimalSeparator As Char` |
| `DoubleValue` | Property | `Public ReadOnly Property DoubleValue As System.Nullable(Of Double)` |
| `IntegerValue` | Property | `Public ReadOnly Property IntegerValue As System.Nullable(Of Integer)` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASPagination`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/Pagination/MASPagination.Events.vb:20`<br>`Component/Navigation/Pagination/MASPagination.Geometry.vb:20`<br>`Component/Navigation/Pagination/MASPagination.Governance.vb:20`<br>`Component/Navigation/Pagination/MASPagination.Interaction.vb:20`<br>`Component/Navigation/Pagination/MASPagination.Layout.vb:20`<br>`Component/Navigation/Pagination/MASPagination.Lifetime.vb:21`<br>`Component/Navigation/Pagination/MASPagination.Rendering.Helpers.vb:20`<br>`Component/Navigation/Pagination/MASPagination.Rendering.vb:21`<br>`Component/Navigation/Pagination/MASPagination.ViewState.vb:21`<br>`Component/Navigation/Pagination/MASPagination.vb:28` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Pagination component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `PageChanged` | Event | `Public Event PageChanged As EventHandler` |
| `Configure` | Function | `Public Function Configure(totalPages As Integer, Optional currentPage As Integer = 1) As MASPagination` |
| `Create` | Function | `Public Shared Function Create(Optional currentPage As Integer = 1, Optional totalPages As Integer = 1) As MASPagination` |
| `MoveFirst` | Function | `Public Function MoveFirst() As MASPagination` |
| `MoveLast` | Function | `Public Function MoveLast() As MASPagination` |
| `MoveNext` | Function | `Public Function MoveNext() As MASPagination` |
| `MovePrevious` | Function | `Public Function MovePrevious() As MASPagination` |
| `WithPageWindow` | Function | `Public Function WithPageWindow(pageWindow As Integer) As MASPagination` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASPagination` |
| `CanMoveNext` | Property | `Public ReadOnly Property CanMoveNext As Boolean` |
| `CanMovePrevious` | Property | `Public ReadOnly Property CanMovePrevious As Boolean` |
| `CurrentPage` | Property | `Public Property CurrentPage As Integer` |
| `PageWindow` | Property | `Public Property PageWindow As Integer` |
| `TotalPages` | Property | `Public Property TotalPages As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASPasswordTextBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TextBox/Controls/MASPasswordTextBox/MASPasswordTextBox.vb:17` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Password Text Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `PasswordVisibilityChanged` | Event | `Public Event PasswordVisibilityChanged As EventHandler` |
| `AsEditable` | Function | `Public Function AsEditable() As MASPasswordTextBox` |
| `AsReadOnly` | Function | `Public Function AsReadOnly() As MASPasswordTextBox` |
| `ClearPassword` | Function | `Public Function ClearPassword() As MASPasswordTextBox` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASPasswordTextBox` |
| `FocusInput` | Function | `Public Function FocusInput() As MASPasswordTextBox` |
| `HidePassword` | Function | `Public Function HidePassword() As MASPasswordTextBox` |
| `SelectTextAll` | Function | `Public Function SelectTextAll() As MASPasswordTextBox` |
| `ShowPassword` | Function | `Public Function ShowPassword() As MASPasswordTextBox` |
| `ShowValidation` | Function | `Public Function ShowValidation(value As Boolean) As MASPasswordTextBox` |
| `TogglePasswordVisibility` | Function | `Public Function TogglePasswordVisibility() As MASPasswordTextBox` |
| `WithMaxLength` | Function | `Public Function WithMaxLength(value As Integer) As MASPasswordTextBox` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASPasswordTextBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASPasswordTextBox` |
| `WithText` | Function | `Public Function WithText(value As String) As MASPasswordTextBox` |
| `WithValidation` | Function | `Public Function WithValidation(state As MASTextValidationState, Optional message As String = Nothing) As MASPasswordTextBox` |
| `WithoutValidation` | Function | `Public Function WithoutValidation() As MASPasswordTextBox` |
| `PasswordVisible` | Property | `Public Property PasswordVisible As Boolean` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASPathTextBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TextBox/Controls/MASPathTextBox/MASPathTextBox.vb:17` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Path Text Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(path As String)` |
| `New` | Sub | `Public Sub New()` |
| `AllowPathWildcards` | Function | `Public Function AllowPathWildcards() As MASPathTextBox` |
| `AsEditable` | Function | `Public Function AsEditable() As MASPathTextBox` |
| `AsReadOnly` | Function | `Public Function AsReadOnly() As MASPathTextBox` |
| `ClearPath` | Function | `Public Function ClearPath() As MASPathTextBox` |
| `Create` | Function | `Public Shared Function Create(Optional path As String = Nothing) As MASPathTextBox` |
| `DisableSlashNormalization` | Function | `Public Function DisableSlashNormalization() As MASPathTextBox` |
| `DisallowPathWildcards` | Function | `Public Function DisallowPathWildcards() As MASPathTextBox` |
| `EnableSlashNormalization` | Function | `Public Function EnableSlashNormalization() As MASPathTextBox` |
| `FocusInput` | Function | `Public Function FocusInput() As MASPathTextBox` |
| `PreserveOuterSpaces` | Function | `Public Function PreserveOuterSpaces() As MASPathTextBox` |
| `SelectTextAll` | Function | `Public Function SelectTextAll() As MASPathTextBox` |
| `ShowValidation` | Function | `Public Function ShowValidation(value As Boolean) As MASPathTextBox` |
| `TrimOuterSpaces` | Function | `Public Function TrimOuterSpaces() As MASPathTextBox` |
| `UseBackslashes` | Function | `Public Function UseBackslashes() As MASPathTextBox` |
| `UseForwardSlashes` | Function | `Public Function UseForwardSlashes() As MASPathTextBox` |
| `WithMaxLength` | Function | `Public Function WithMaxLength(value As Integer) As MASPathTextBox` |
| `WithPath` | Function | `Public Function WithPath(value As String) As MASPathTextBox` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASPathTextBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASPathTextBox` |
| `WithText` | Function | `Public Function WithText(value As String) As MASPathTextBox` |
| `WithValidation` | Function | `Public Function WithValidation(state As MASTextValidationState, Optional message As String = Nothing) As MASPathTextBox` |
| `WithoutValidation` | Function | `Public Function WithoutValidation() As MASPathTextBox` |
| `AllowWildcards` | Property | `Public Property AllowWildcards As Boolean` |
| `HasInvalidPathChars` | Property | `Public ReadOnly Property HasInvalidPathChars As Boolean` |
| `LooksLikeAbsolutePath` | Property | `Public ReadOnly Property LooksLikeAbsolutePath As Boolean` |
| `NormalizeSlashes` | Property | `Public Property NormalizeSlashes As Boolean` |
| `NormalizedPathText` | Property | `Public ReadOnly Property NormalizedPathText As String` |
| `PreferredSlash` | Property | `Public Property PreferredSlash As Char` |
| `TrimOuterSpacesOnAssign` | Property | `Public Property TrimOuterSpacesOnAssign As Boolean` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASPivotTable`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/PivotTable/MASPivotTable.Geometry.vb:21`<br>`Component/Data/PivotTable/MASPivotTable.Helpers.vb:21`<br>`Component/Data/PivotTable/MASPivotTable.Interaction.vb:21`<br>`Component/Data/PivotTable/MASPivotTable.Layout.vb:21`<br>`Component/Data/PivotTable/MASPivotTable.MatrixWindow.vb:163`<br>`Component/Data/PivotTable/MASPivotTable.Motion.vb:9`<br>`Component/Data/PivotTable/MASPivotTable.PivotSource.vb:15`<br>`Component/Data/PivotTable/MASPivotTable.Rendering.vb:21`<br>`Component/Data/PivotTable/MASPivotTable.vb:28` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Pivot Table component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `PivotTableChanged` | Event | `Public Event PivotTableChanged As EventHandler` |
| `SelectedCellChanged` | Event | `Public Event SelectedCellChanged As EventHandler` |
| `AddColumn` | Function | `Public Function AddColumn(columnKey As String, header As String) As MASPivotTable` |
| `AddRow` | Function | `Public Function AddRow(rowKey As String, label As String) As MASPivotTable` |
| `ClearAll` | Function | `Public Function ClearAll() As MASPivotTable` |
| `ClearColumns` | Function | `Public Function ClearColumns() As MASPivotTable` |
| `ClearRows` | Function | `Public Function ClearRows() As MASPivotTable` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASPivotTable` |
| `GetCellValue` | Function | `Public Function GetCellValue(rowKey As String, columnKey As String) As Decimal` |
| `GetColumnKeys` | Function | `Public Function GetColumnKeys() As IReadOnlyList(Of String)` |
| `GetColumnTotal` | Function | `Public Function GetColumnTotal(columnKey As String) As Decimal` |
| `GetRowKeys` | Function | `Public Function GetRowKeys() As IReadOnlyList(Of String)` |
| `GetRowTotal` | Function | `Public Function GetRowTotal(rowKey As String) As Decimal` |
| `SelectCell` | Function | `Public Function SelectCell(rowKey As String, columnKey As String) As Boolean` |
| `SetCellValue` | Function | `Public Function SetCellValue(rowKey As String, columnKey As String, value As Decimal) As MASPivotTable` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASPivotTable` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASPivotTable` |
| `ColumnCount` | Property | `Public ReadOnly Property ColumnCount As Integer` |
| `GrandTotal` | Property | `Public ReadOnly Property GrandTotal As Decimal` |
| `RowCount` | Property | `Public ReadOnly Property RowCount As Integer` |
| `SelectedColumnKey` | Property | `Public ReadOnly Property SelectedColumnKey As String` |
| `SelectedRowKey` | Property | `Public ReadOnly Property SelectedRowKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASPropertyGrid`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Editor/PropertyGrid/Control/MASPropertyGrid.vb:26` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Property Grid component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `PropertyValueChanged` | Event | `Public Event PropertyValueChanged As EventHandler` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddProperty` | Function | `Public Function AddProperty(category As String, name As String, value As Object, Optional editable As Boolean = True) As MASPropertyGrid` |
| `ClearFilter` | Function | `Public Function ClearFilter() As MASPropertyGrid` |
| `ClearProperties` | Function | `Public Function ClearProperties() As MASPropertyGrid` |
| `CollapseAllCategories` | Function | `Public Function CollapseAllCategories() As MASPropertyGrid` |
| `Create` | Function | `Public Shared Function Create(Optional source As Object = Nothing) As MASPropertyGrid` |
| `ExpandAllCategories` | Function | `Public Function ExpandAllCategories() As MASPropertyGrid` |
| `SelectProperty` | Function | `Public Function SelectProperty(propertyName As String) As Boolean` |
| `SetObject` | Function | `Public Function SetObject(source As Object) As MASPropertyGrid` |
| `ToggleCategory` | Function | `Public Function ToggleCategory(category As String) As MASPropertyGrid` |
| `TrySetValueText` | Function | `Public Function TrySetValueText(propertyName As String, valueText As String) As Boolean` |
| `TrySetValue` | Function | `Public Function TrySetValue(propertyName As String, value As Object) As Boolean` |
| `WithFilterText` | Function | `Public Function WithFilterText(value As String) As MASPropertyGrid` |
| `WithObject` | Function | `Public Function WithObject(source As Object) As MASPropertyGrid` |
| `WithTitle` | Function | `Public Function WithTitle(title As String) As MASPropertyGrid` |
| `CategoryCount` | Property | `Public ReadOnly Property CategoryCount As Integer` |
| `FilterText` | Property | `Public Property FilterText As String` |
| `HasSelection` | Property | `Public ReadOnly Property HasSelection As Boolean` |
| `IsObjectBound` | Property | `Public ReadOnly Property IsObjectBound As Boolean` |
| `PropertyCount` | Property | `Public ReadOnly Property PropertyCount As Integer` |
| `SelectedPropertyName` | Property | `Public ReadOnly Property SelectedPropertyName As String` |
| `SelectedValueText` | Property | `Public ReadOnly Property SelectedValueText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASRadioButton`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/RadioButton/MASRadioButton.vb:24` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Provides the advanced Radio Button component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `CheckedChanged` | Event | `Public Event CheckedChanged As EventHandler` |
| `CheckedState` | Function | `Public Function CheckedState(Optional value As Boolean = True) As MASRadioButton` |
| `Create` | Function | `Public Shared Function Create() As MASRadioButton` |
| `SelectRadio` | Function | `Public Function SelectRadio() As MASRadioButton` |
| `SelectThis` | Sub | `Public Sub SelectThis()` |
| `Unchecked` | Function | `Public Function Unchecked() As MASRadioButton` |
| `WithGroup` | Function | `Public Function WithGroup(name As String) As MASRadioButton` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASRadioButton` |
| `WithText` | Function | `Public Function WithText(text As String) As MASRadioButton` |
| `Checked` | Property | `Public Property Checked As Boolean` |
| `GroupName` | Property | `Public Property GroupName As String` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASRating`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Feedback/Rating/MASRating.vb:28` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Rating component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ValueChanged` | Event | `Public Event ValueChanged As EventHandler` |
| `ClearRating` | Function | `Public Function ClearRating() As MASRating` |
| `Create` | Function | `Public Shared Function Create(Optional value As Double = 0.0, Optional maximum As Integer = 5) As MASRating` |
| `SetRating` | Function | `Public Function SetRating(value As Double) As MASRating` |
| `WithHalfValues` | Function | `Public Function WithHalfValues(value As Boolean) As MASRating` |
| `WithLabel` | Function | `Public Function WithLabel(value As String) As MASRating` |
| `WithMaximum` | Function | `Public Function WithMaximum(value As Integer) As MASRating` |
| `WithReadOnly` | Function | `Public Function WithReadOnly(value As Boolean) As MASRating` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASRating` |
| `WithValue` | Function | `Public Function WithValue(value As Double) As MASRating` |
| `AllowHalfValues` | Property | `Public Property AllowHalfValues As Boolean` |
| `IsReadOnly` | Property | `Public Property IsReadOnly As Boolean` |
| `Label` | Property | `Public Property Label As String` |
| `Maximum` | Property | `Public Property Maximum As Integer` |
| `ValueText` | Property | `Public ReadOnly Property ValueText As String` |
| `Value` | Property | `Public Property Value As Double` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASSearchTextBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TextBox/Controls/MASSearchTextBox/MASSearchTextBox.Advanced.vb:21`<br>`Component/Inputs/TextBox/Controls/MASSearchTextBox/MASSearchTextBox.vb:17` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Search Text Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `SearchCommitted` | Event | `Public Event SearchCommitted As EventHandler` |
| `AcceptSuggestion` | Function | `Public Function AcceptSuggestion(index As Integer) As MASSearchTextBox` |
| `AddFilterExpression` | Function | `Public Function AddFilterExpression(expressionText As String) As MASSearchTextBox` |
| `AddFilterToken` | Function | `Public Function AddFilterToken(columnKey As String, valueText As String) As MASSearchTextBox` |
| `AddRecentSearch` | Function | `Public Function AddRecentSearch(value As String) As MASSearchTextBox` |
| `AddSuggestion` | Function | `Public Function AddSuggestion(value As String) As MASSearchTextBox` |
| `AsEditable` | Function | `Public Function AsEditable() As MASSearchTextBox` |
| `AsReadOnly` | Function | `Public Function AsReadOnly() As MASSearchTextBox` |
| `BindToDataGrid` | Function | `Public Function BindToDataGrid(grid As MASDataGrid) As MASSearchTextBox` |
| `ClearFilterTokens` | Function | `Public Function ClearFilterTokens() As MASSearchTextBox` |
| `ClearRecentSearches` | Function | `Public Function ClearRecentSearches() As MASSearchTextBox` |
| `ClearSearch` | Function | `Public Function ClearSearch() As MASSearchTextBox` |
| `ClearSuggestions` | Function | `Public Function ClearSuggestions() As MASSearchTextBox` |
| `CommitSearch` | Function | `Public Function CommitSearch() As MASSearchTextBox` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASSearchTextBox` |
| `FocusInput` | Function | `Public Function FocusInput() As MASSearchTextBox` |
| `SelectTextAll` | Function | `Public Function SelectTextAll() As MASSearchTextBox` |
| `SetSuggestions` | Function | `Public Function SetSuggestions(values As IEnumerable(Of String)) As MASSearchTextBox` |
| `ShowValidation` | Function | `Public Function ShowValidation(value As Boolean) As MASSearchTextBox` |
| `UnbindDataGrid` | Function | `Public Function UnbindDataGrid() As MASSearchTextBox` |
| `WithMaxLength` | Function | `Public Function WithMaxLength(value As Integer) As MASSearchTextBox` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASSearchTextBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASSearchTextBox` |
| `WithText` | Function | `Public Function WithText(value As String) As MASSearchTextBox` |
| `WithValidation` | Function | `Public Function WithValidation(state As MASTextValidationState, Optional message As String = Nothing) As MASSearchTextBox` |
| `WithoutValidation` | Function | `Public Function WithoutValidation() As MASSearchTextBox` |
| `EffectiveSearchText` | Property | `Public ReadOnly Property EffectiveSearchText As String` |
| `FilterTokenCount` | Property | `Public ReadOnly Property FilterTokenCount As Integer` |
| `MaxRecentSearches` | Property | `Public Property MaxRecentSearches As Integer` |
| `RecentSearchCount` | Property | `Public ReadOnly Property RecentSearchCount As Integer` |
| `SuggestionCount` | Property | `Public ReadOnly Property SuggestionCount As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASSegmentEntry`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Selectors/SegmentedControl/MASSegmentEntry.vb:12` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Provides a typed model/DTO used by the Segment Entry control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(id As String, label As String, Optional tag As Object = Nothing)` |
| `Id` | Property | `Public ReadOnly Property Id As String` |
| `Label` | Property | `Public ReadOnly Property Label As String` |
| `Tag` | Property | `Public ReadOnly Property Tag As Object` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASSelectorItemEntry`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Selectors/SelectorItem/MASSelectorItemEntry.vb:14` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Provides a typed model/DTO used by the Selector Item Entry control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(id As String, label As String, count As Integer, glyph As MASSelectorItemGlyphKind, accent As SKColor, Optional tag As Object = Nothing)` |
| `Accent` | Property | `Public ReadOnly Property Accent As SKColor` |
| `Count` | Property | `Public ReadOnly Property Count As Integer` |
| `Glyph` | Property | `Public ReadOnly Property Glyph As MASSelectorItemGlyphKind` |
| `Id` | Property | `Public ReadOnly Property Id As String` |
| `Label` | Property | `Public ReadOnly Property Label As String` |
| `Tag` | Property | `Public ReadOnly Property Tag As Object` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASSlider`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/Slider/MASSlider.vb:26` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Slider component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `RangeChanged` | Event | `Public Event RangeChanged As EventHandler` |
| `ValueChanged` | Event | `Public Event ValueChanged As EventHandler` |
| `Create` | Function | `Public Shared Function Create(Optional minimum As Double = 0.0, Optional maximum As Double = 100.0, Optional value As Double = 0.0) As MASSlider` |
| `WithRange` | Function | `Public Function WithRange(minimum As Double, maximum As Double) As MASSlider` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASSlider` |
| `WithStep` | Function | `Public Function WithStep(stepValue As Double) As MASSlider` |
| `WithTicks` | Function | `Public Function WithTicks(Optional tickFrequency As Double = 10.0) As MASSlider` |
| `WithValueLabel` | Function | `Public Function WithValueLabel(Optional visible As Boolean = True) As MASSlider` |
| `WithValue` | Function | `Public Function WithValue(value As Double) As MASSlider` |
| `WithoutTicks` | Function | `Public Function WithoutTicks() As MASSlider` |
| `WithoutValueLabel` | Function | `Public Function WithoutValueLabel() As MASSlider` |
| `Maximum` | Property | `Public Property Maximum As Double` |
| `Minimum` | Property | `Public Property Minimum As Double` |
| `ShowTicks` | Property | `Public Property ShowTicks As Boolean` |
| `ShowValueLabel` | Property | `Public Property ShowValueLabel As Boolean` |
| `Step` | Property | `Public Property Step As Double` |
| `TickFrequency` | Property | `Public Property TickFrequency As Double` |
| `Value` | Property | `Public Property Value As Double` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASSplitButton`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Buttons/MASSplitButton/MASSplitButton.Helpers.vb:23`<br>`Component/Buttons/MASSplitButton/MASSplitButton.Interaction.vb:22`<br>`Component/Buttons/MASSplitButton/MASSplitButton.Layout.vb:22`<br>`Component/Buttons/MASSplitButton/MASSplitButton.Lifetime.vb:23`<br>`Component/Buttons/MASSplitButton/MASSplitButton.Rendering.vb:22`<br>`Component/Buttons/MASSplitButton/MASSplitButton.RuntimeServices.vb:22`<br>`Component/Buttons/MASSplitButton/MASSplitButton.vb:28` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Provides the advanced Split Button component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `Click` | Event | `Public Event Click As EventHandler` |
| `CommandChanged` | Event | `Public Event CommandChanged As EventHandler` |
| `MenuClosed` | Event | `Public Event MenuClosed As EventHandler` |
| `MenuOpening` | Event | `Public Event MenuOpening As EventHandler` |
| `CanActivate` | Function | `Public Function CanActivate() As Boolean` |
| `ClearIcon` | Sub | `Public Sub ClearIcon()` |
| `CloseMenu` | Sub | `Public Sub CloseMenu()` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASSplitButton` |
| `GetMenuAnchorRectPx` | Function | `Public Function GetMenuAnchorRectPx() As SKRect` |
| `OnCommand` | Function | `Public Function OnCommand(commandHandler As Action(Of String)) As MASSplitButton` |
| `PerformClick` | Sub | `Public Sub PerformClick()` |
| `SetIcon` | Sub | `Public Sub SetIcon(drawIcon As Action(Of SKCanvas, SKRect, Single, SKColor), Optional drawIconEmphasis As Action(Of SKCanvas, SKRect, Single, SKColor) = Nothing)` |
| `ShowMenu` | Sub | `Public Sub ShowMenu()` |
| `WithAction` | Function | `Public Function WithAction(text As String, commandId As String, Optional handler As Action = Nothing, Optional enabled As Boolean = True, Optional shortcutText As String = "", Optional intent As MASDropDownMenuItemIntent = MASDropDownMenuItemIntent.Default) As MASSplitButton` |
| `WithIconPlacement` | Function | `Public Function WithIconPlacement(value As MASButtonIconPlacement) As MASSplitButton` |
| `WithIcon` | Function | `Public Function WithIcon(drawIcon As Action(Of SKCanvas, SKRect, Single, SKColor), Optional drawIconEmphasis As Action(Of SKCanvas, SKRect, Single, SKColor) = Nothing) As MASSplitButton` |
| `WithIntent` | Function | `Public Function WithIntent(value As MASButtonIntent) As MASSplitButton` |
| `WithMenu` | Function | `Public Function WithMenu(buildMenu As Action(Of MASDropDownMenuBuilder)) As MASSplitButton` |
| `WithPrimaryCommand` | Function | `Public Function WithPrimaryCommand(action As Action(Of MASSplitButton)) As MASSplitButton` |
| `WithSeparator` | Function | `Public Function WithSeparator() As MASSplitButton` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASSplitButton` |
| `WithSubMenu` | Function | `Public Function WithSubMenu(text As String, configure As Action(Of MASDropDownMenuBuilder), Optional enabled As Boolean = True) As MASSplitButton` |
| `WithText` | Function | `Public Function WithText(value As String) As MASSplitButton` |
| `WithTooltip` | Function | `Public Function WithTooltip(value As String) As MASSplitButton` |
| `WithoutIcon` | Function | `Public Function WithoutIcon() As MASSplitButton` |
| `CommandHandler` | Property | `Public Property CommandHandler As Action(Of String)` |
| `HasIcon` | Property | `Public ReadOnly Property HasIcon As Boolean` |
| `IconPlacement` | Property | `Public Property IconPlacement As MASButtonIconPlacement` |
| `Intent` | Property | `Public Property Intent As MASButtonIntent` |
| `IsMenuOpen` | Property | `Public ReadOnly Property IsMenuOpen As Boolean` |
| `MainCommand` | Property | `Public Property MainCommand As Action(Of MASSplitButton)` |
| `MenuBuilder` | Property | `Public Property MenuBuilder As Action(Of MASDropDownMenuBuilder)` |
| `Text` | Property | `Public Property Text As String` |
| `Tooltip` | Property | `Public Property Tooltip As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASSplitView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Container/SplitView/MASSplitView.Events.vb:19`<br>`Component/Container/SplitView/MASSplitView.Geometry.vb:19`<br>`Component/Container/SplitView/MASSplitView.Governance.vb:19`<br>`Component/Container/SplitView/MASSplitView.Helpers.vb:19`<br>`Component/Container/SplitView/MASSplitView.HostAdoption.vb:9`<br>`Component/Container/SplitView/MASSplitView.HostAdoptionSample.vb:9`<br>`Component/Container/SplitView/MASSplitView.Hosting.vb:11`<br>`Component/Container/SplitView/MASSplitView.Interaction.vb:19`<br>`Component/Container/SplitView/MASSplitView.KeyboardSplitter.vb:82`<br>`Component/Container/SplitView/MASSplitView.Layout.vb:19`<br>`Component/Container/SplitView/MASSplitView.Motion.vb:12`<br>`Component/Container/SplitView/MASSplitView.Persistence.vb:58`<br>`Component/Container/SplitView/MASSplitView.Rendering.vb:19`<br>`Component/Container/SplitView/MASSplitView.ShellBoundary.vb:6`<br>`Component/Container/SplitView/MASSplitView.ViewState.vb:19`<br>`Component/Container/SplitView/MASSplitView.vb:27` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the advanced Split View component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SplitViewChanged` | Event | `Public Event SplitViewChanged As EventHandler` |
| `CollapseLeft` | Function | `Public Function CollapseLeft(Optional collapsed As Boolean = True) As MASSplitView` |
| `CollapseRight` | Function | `Public Function CollapseRight(Optional collapsed As Boolean = True) As MASSplitView` |
| `CreateLayoutSnapshot` | Function | `Public Function CreateLayoutSnapshot() As MASSplitViewLayoutSnapshot` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASSplitView` |
| `ExpandAll` | Function | `Public Function ExpandAll() As MASSplitView` |
| `ResetPaneLayout` | Function | `Public Function ResetPaneLayout() As MASSplitView` |
| `RestoreLayoutSnapshot` | Function | `Public Function RestoreLayoutSnapshot(snapshot As MASSplitViewLayoutSnapshot) As Boolean` |
| `SetPaneTexts` | Function | `Public Function SetPaneTexts(leftText As String, contentText As String, rightText As String) As MASSplitView` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASSplitView` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASSplitView` |
| `ContentPaneText` | Property | `Public Property ContentPaneText As String` |
| `ContentPaneTitle` | Property | `Public Property ContentPaneTitle As String` |
| `IsLeftPaneCollapsed` | Property | `Public Property IsLeftPaneCollapsed As Boolean` |
| `IsRightPaneCollapsed` | Property | `Public Property IsRightPaneCollapsed As Boolean` |
| `LeftPaneRatio` | Property | `Public Property LeftPaneRatio As Single` |
| `LeftPaneText` | Property | `Public Property LeftPaneText As String` |
| `LeftPaneTitle` | Property | `Public Property LeftPaneTitle As String` |
| `RightPaneRatio` | Property | `Public Property RightPaneRatio As Single` |
| `RightPaneText` | Property | `Public Property RightPaneText As String` |
| `RightPaneTitle` | Property | `Public Property RightPaneTitle As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASSplitViewLayoutSnapshot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Preview` |
| V1 approval | `—` |
| Evidence | `Component/Container/SplitView/MASSplitView.Persistence.vb:14` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Represents a captured state snapshot for the Split View Layout Snapshot component.

**When to use it.** Use it for diagnostics, layout state, or component state inspection where the owning component exposes it.

**Stability note.** Preview surface is documented for completeness, but it is not a V1 stable customer contract.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(version As Integer, title As String, leftPaneTitle As String, contentPaneTitle As String, rightPaneTitle As String, leftPaneText As String, contentPaneText As String, rightPaneText As String, leftPaneRatio As Single, rightPaneRatio As Single, leftPaneCollapsed As Boolean, rightPaneCollapsed As Boolean)` |
| `ContentPaneText` | Property | `Public ReadOnly Property ContentPaneText As String` |
| `ContentPaneTitle` | Property | `Public ReadOnly Property ContentPaneTitle As String` |
| `LeftPaneCollapsed` | Property | `Public ReadOnly Property LeftPaneCollapsed As Boolean` |
| `LeftPaneRatio` | Property | `Public ReadOnly Property LeftPaneRatio As Single` |
| `LeftPaneText` | Property | `Public ReadOnly Property LeftPaneText As String` |
| `LeftPaneTitle` | Property | `Public ReadOnly Property LeftPaneTitle As String` |
| `RightPaneCollapsed` | Property | `Public ReadOnly Property RightPaneCollapsed As Boolean` |
| `RightPaneRatio` | Property | `Public ReadOnly Property RightPaneRatio As Single` |
| `RightPaneText` | Property | `Public ReadOnly Property RightPaneText As String` |
| `RightPaneTitle` | Property | `Public ReadOnly Property RightPaneTitle As String` |
| `Title` | Property | `Public ReadOnly Property Title As String` |
| `Version` | Property | `Public ReadOnly Property Version As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTagInput`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TagInput/MASTagInput.Events.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Geometry.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Interaction.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.ItemModel.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Layout.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Lifetime.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Motion.vb:13`<br>`Component/Inputs/TagInput/MASTagInput.PendingInput.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Rendering.Helpers.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Rendering.Tags.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.Rendering.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.ViewState.vb:20`<br>`Component/Inputs/TagInput/MASTagInput.vb:26` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Tag Input component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectedIndexChanged` | Event | `Public Event SelectedIndexChanged As EventHandler` |
| `TagsChanged` | Event | `Public Event TagsChanged As EventHandler` |
| `AddTag` | Function | `Public Function AddTag(text As String) As MASTagInput` |
| `ClearTags` | Function | `Public Function ClearTags() As MASTagInput` |
| `Create` | Function | `Public Shared Function Create(Optional tags As IEnumerable(Of String) = Nothing) As MASTagInput` |
| `GetTagText` | Function | `Public Function GetTagText(index As Integer) As String` |
| `RemoveTagAt` | Function | `Public Function RemoveTagAt(index As Integer) As MASTagInput` |
| `RemoveTag` | Function | `Public Function RemoveTag(text As String) As MASTagInput` |
| `SetTags` | Function | `Public Function SetTags(tags As IEnumerable(Of String)) As MASTagInput` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(text As String) As MASTagInput` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(index As Integer) As MASTagInput` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTagInput` |
| `Placeholder` | Property | `Public Property Placeholder As String` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `SelectedText` | Property | `Public ReadOnly Property SelectedText As String` |
| `TagCount` | Property | `Public ReadOnly Property TagCount As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTextBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TextBox/Controls/MASTextBox/MASTextBox.vb:12` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Text Box component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `AsEditable` | Function | `Public Function AsEditable() As MASTextBox` |
| `AsReadOnly` | Function | `Public Function AsReadOnly() As MASTextBox` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASTextBox` |
| `FocusInput` | Function | `Public Function FocusInput() As MASTextBox` |
| `SelectTextAll` | Function | `Public Function SelectTextAll() As MASTextBox` |
| `ShowValidation` | Function | `Public Function ShowValidation(value As Boolean) As MASTextBox` |
| `WithMaxLength` | Function | `Public Function WithMaxLength(value As Integer) As MASTextBox` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASTextBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTextBox` |
| `WithText` | Function | `Public Function WithText(value As String) As MASTextBox` |
| `WithValidation` | Function | `Public Function WithValidation(state As MASTextValidationState, Optional message As String = Nothing) As MASTextBox` |
| `WithoutValidation` | Function | `Public Function WithoutValidation() As MASTextBox` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTileBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Surfaces/Tiles/MASTileBox.BitmapOwnership.vb:12`<br>`Component/Surfaces/Tiles/MASTileBox.Input.vb:26`<br>`Component/Surfaces/Tiles/MASTileBox.Items.vb:27`<br>`Component/Surfaces/Tiles/MASTileBox.Layout.vb:27`<br>`Component/Surfaces/Tiles/MASTileBox.Rendering.vb:27`<br>`Component/Surfaces/Tiles/MASTileBox.Selection.vb:27`<br>`Component/Surfaces/Tiles/MASTileBox.Virtualization.vb:26`<br>`Component/Surfaces/Tiles/MASTileBox.vb:27` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** An advanced tile selection and visualization component.

**When to use it.** Use it for tile galleries or selectable visual item collections with documented virtualization/performance boundaries.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ItemClicked` | Event | `Public Event ItemClicked As EventHandler(Of MASTileBox.MASTileClickedEventArgs)` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddItems` | Function | `Public Function AddItems(items As IEnumerable(Of MASTileBox.MASTileItem)) As MASTileBox` |
| `AddItem` | Function | `Public Function AddItem(item As MASTileBox.MASTileItem) As MASTileBox` |
| `AddItem` | Function | `Public Function AddItem(title As String, subtitle As String, bitmap As SKBitmap, bitmapDisposer As Action(Of SKBitmap)) As MASTileBox` |
| `AddItem` | Function | `Public Function AddItem(title As String, subtitle As String, bitmap As SKBitmap, takeOwnership As Boolean) As MASTileBox` |
| `AddItem` | Function | `Public Function AddItem(title As String, subtitle As String, bitmap As SKBitmap) As MASTileBox` |
| `AddItem` | Function | `Public Function AddItem(title As String, subtitle As String, iconId As System.Guid, provider As Func(Of SKBitmap), bitmapDisposer As Action(Of SKBitmap)) As MASTileBox` |
| `AddItem` | Function | `Public Function AddItem(title As String, subtitle As String, iconId As System.Guid, provider As Func(Of SKBitmap), takeOwnership As Boolean) As MASTileBox` |
| `AddItem` | Function | `Public Function AddItem(title As String, subtitle As String, iconId As System.Guid, provider As Func(Of SKBitmap)) As MASTileBox` |
| `ClearItems` | Function | `Public Function ClearItems() As MASTileBox` |
| `ClearSelection` | Function | `Public Function ClearSelection() As MASTileBox` |
| `Create` | Function | `Public Shared Function Create() As MASTileBox` |
| `Disable` | Function | `Public Function Disable() As MASTileBox` |
| `Enable` | Function | `Public Function Enable() As MASTileBox` |
| `Hide` | Function | `Public Function Hide() As MASTileBox` |
| `ReplaceItems` | Function | `Public Function ReplaceItems(items As IEnumerable(Of MASTileBox.MASTileItem)) As MASTileBox` |
| `Show` | Function | `Public Function Show() As MASTileBox` |
| `WithEnabled` | Function | `Public Function WithEnabled(value As Boolean) As MASTileBox` |
| `WithSelectedId` | Function | `Public Function WithSelectedId(id As System.Guid) As MASTileBox` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(index As Integer) As MASTileBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTileBox` |
| `WithVisible` | Function | `Public Function WithVisible(value As Boolean) As MASTileBox` |
| `Items` | Property | `Public ReadOnly Property Items As IReadOnlyList(Of MASTileBox.MASTileItem)` |
| `SelectedId` | Property | `Public Property SelectedId As System.Guid` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `SelectedItem` | Property | `Public ReadOnly Property SelectedItem As MASTileBox.MASTileItem` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTileBox.MASTileClickedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| CLR identity | `Nexamas.UI.Components.MASTileBox.MASTileClickedEventArgs` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Surfaces/Tiles/MASTileBox.Items.vb:29` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Carries typed event data for Tile Clicked Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Index` | Property | `Public ReadOnly Property Index As Integer` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASTileBox.MASTileItem`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| CLR identity | `Nexamas.UI.Components.MASTileBox.MASTileItem` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Surfaces/Tiles/MASTileBox.BitmapOwnership.vb:14` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides a typed model/DTO used by the Tile Item control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(title As String, subtitle As String, bmp As SKBitmap, bitmapDisposer As Action(Of SKBitmap))` |
| `New` | Sub | `Public Sub New(title As String, subtitle As String, bmp As SKBitmap, takeOwnership As Boolean)` |
| `New` | Sub | `Public Sub New(title As String, subtitle As String, bmp As SKBitmap)` |
| `New` | Sub | `Public Sub New(title As String, subtitle As String, iconId As System.Guid, provider As Func(Of SKBitmap), bitmapDisposer As Action(Of SKBitmap))` |
| `New` | Sub | `Public Sub New(title As String, subtitle As String, iconId As System.Guid, provider As Func(Of SKBitmap), takeOwnership As Boolean)` |
| `New` | Sub | `Public Sub New(title As String, subtitle As String, iconId As System.Guid, provider As Func(Of SKBitmap))` |
| `New` | Sub | `Public Sub New()` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `GetBitmap` | Function | `Public Function GetBitmap() As SKBitmap` |
| `ToString` | Function | `Public Function ToString() As String` |
| `IconId` | Property | `Public Property IconId As System.Guid` |
| `Subtitle` | Property | `Public Property Subtitle As String` |
| `Tag` | Property | `Public Property Tag As Object` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTimePicker`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/TimePicker/MASTimePicker.Events.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.Geometry.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.Interaction.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.Layout.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.Parsing.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.Popup.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.Rendering.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.ViewState.vb:22`<br>`Component/Inputs/TimePicker/MASTimePicker.vb:27` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Time Picker component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectedTimeChanged` | Event | `Public Event SelectedTimeChanged As EventHandler` |
| `ClearTime` | Function | `Public Function ClearTime() As MASTimePicker` |
| `Create` | Function | `Public Shared Function Create() As MASTimePicker` |
| `WithMinuteStep` | Function | `Public Function WithMinuteStep(value As Integer) As MASTimePicker` |
| `WithPlaceholder` | Function | `Public Function WithPlaceholder(value As String) As MASTimePicker` |
| `WithSelectedTime` | Function | `Public Function WithSelectedTime(value As System.TimeSpan) As MASTimePicker` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTimePicker` |
| `WithTimeRange` | Function | `Public Function WithTimeRange(minimumTime As System.Nullable(Of System.TimeSpan), maximumTime As System.Nullable(Of System.TimeSpan)) As MASTimePicker` |
| `DisplayText` | Property | `Public ReadOnly Property DisplayText As String` |
| `MaximumTime` | Property | `Public Property MaximumTime As System.Nullable(Of System.TimeSpan)` |
| `MinimumTime` | Property | `Public Property MinimumTime As System.Nullable(Of System.TimeSpan)` |
| `MinuteStep` | Property | `Public Property MinuteStep As Integer` |
| `Placeholder` | Property | `Public Property Placeholder As String` |
| `SelectedTime` | Property | `Public Property SelectedTime As System.Nullable(Of System.TimeSpan)` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTimeline`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Feedback/Timeline/MASTimeline.vb:28` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Timeline component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ItemClicked` | Event | `Public Event ItemClicked As EventHandler` |
| `ItemsChanged` | Event | `Public Event ItemsChanged As EventHandler` |
| `SelectedIndexChanged` | Event | `Public Event SelectedIndexChanged As EventHandler` |
| `AddItem` | Function | `Public Function AddItem(title As String, Optional detail As String = "", Optional timestampText As String = "", Optional state As MASTimelineItemState = MASTimelineItemState.Normal) As MASTimeline` |
| `ClearItems` | Function | `Public Function ClearItems() As MASTimeline` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional description As String = Nothing) As MASTimeline` |
| `GetItemDetail` | Function | `Public Function GetItemDetail(index As Integer) As String` |
| `GetItemState` | Function | `Public Function GetItemState(index As Integer) As MASTimelineItemState` |
| `GetItemTimestampText` | Function | `Public Function GetItemTimestampText(index As Integer) As String` |
| `GetItemTitle` | Function | `Public Function GetItemTitle(index As Integer) As String` |
| `RemoveItemAt` | Function | `Public Function RemoveItemAt(index As Integer) As MASTimeline` |
| `WithCompact` | Function | `Public Function WithCompact(Optional value As Boolean = True) As MASTimeline` |
| `WithDescription` | Function | `Public Function WithDescription(value As String) As MASTimeline` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(index As Integer) As MASTimeline` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTimeline` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASTimeline` |
| `Compact` | Property | `Public Property Compact As Boolean` |
| `Description` | Property | `Public Property Description As String` |
| `ItemCount` | Property | `Public ReadOnly Property ItemCount As Integer` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASToggleSwitch`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/ToggleSwitch/MASToggleSwitch.vb:23` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Provides the advanced Toggle Switch component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `CheckedChanged` | Event | `Public Event CheckedChanged As EventHandler` |
| `CheckedState` | Function | `Public Function CheckedState(Optional value As Boolean = True) As MASToggleSwitch` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing, Optional isChecked As Boolean = False) As MASToggleSwitch` |
| `SetChecked` | Sub | `Public Sub SetChecked(value As Boolean)` |
| `ToggleState` | Function | `Public Function ToggleState() As MASToggleSwitch` |
| `Toggle` | Sub | `Public Sub Toggle()` |
| `Unchecked` | Function | `Public Function Unchecked() As MASToggleSwitch` |
| `WithChecked` | Function | `Public Function WithChecked(Optional value As Boolean = True) As MASToggleSwitch` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASToggleSwitch` |
| `WithText` | Function | `Public Function WithText(text As String) As MASToggleSwitch` |
| `Checked` | Property | `Public Property Checked As Boolean` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASToolbar`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Reusable/Toolbar/MASToolbar.Api.vb:20`<br>`Component/Reusable/Toolbar/MASToolbar.CommandBar.vb:15`<br>`Component/Reusable/Toolbar/MASToolbar.CommandBarPremium.vb:6`<br>`Component/Reusable/Toolbar/MASToolbar.Events.vb:20`<br>`Component/Reusable/Toolbar/MASToolbar.Helpers.vb:20`<br>`Component/Reusable/Toolbar/MASToolbar.Items.vb:20`<br>`Component/Reusable/Toolbar/MASToolbar.Layout.vb:20`<br>`Component/Reusable/Toolbar/MASToolbar.Lifetime.vb:20`<br>`Component/Reusable/Toolbar/MASToolbar.Rendering.vb:20`<br>`Component/Reusable/Toolbar/MASToolbar.vb:19` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Toolbar component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ButtonClicked` | Event | `Public Event ButtonClicked As EventHandler(Of MASToolbarButtonClickedEventArgs)` |
| `AddCommand` | Function | `Public Function AddCommand(commandId As String, text As String, Optional description As String = "", Optional iconKind As MASIconKind = MASIconKind.None, Optional action As Action(Of MASButton) = Nothing, Optional intent As MASButtonIntent = MASButtonIntent.Default, Optional widthDip As Single = 0.0, Optional alignment As MASToolbarItemAlignment = MASToolbarItemAlignment.Left) As MASButton` |
| `AddControl` | Sub | `Public Sub AddControl(id As String, control As MASControlBase, widthDip As Single, Optional sizing As MASToolbarItemSizing = MASToolbarItemSizing.Fixed, Optional alignment As MASToolbarItemAlignment = MASToolbarItemAlignment.Left, Optional minWidthDip As Single = 0.0, Optional maxWidthDip As Single = 0.0)` |
| `AddFillControl` | Sub | `Public Sub AddFillControl(id As String, control As MASControlBase, Optional minWidthDip As Single = 0.0, Optional maxWidthDip As Single = 0.0)` |
| `AddFlexibleSpacer` | Function | `Public Function AddFlexibleSpacer(Optional id As String = "", Optional alignment As MASToolbarItemAlignment = MASToolbarItemAlignment.Left, Optional minWidthDip As Single = 0.0, Optional maxWidthDip As Single = 0.0) As MASToolbarSpacer` |
| `AddSearchBox` | Function | `Public Function AddSearchBox(id As String, Optional placeholder As String = "Search...", Optional widthDip As Single = 180.0, Optional sizing As MASToolbarItemSizing = MASToolbarItemSizing.Fixed, Optional alignment As MASToolbarItemAlignment = MASToolbarItemAlignment.Left, Optional minWidthDip As Single = 90.0, Optional maxWidthDip As Single = 0.0) As MASSearchTextBox` |
| `AddSeparator` | Function | `Public Function AddSeparator(Optional id As String = "", Optional alignment As MASToolbarItemAlignment = MASToolbarItemAlignment.Left) As MASToolbarSeparator` |
| `AddSpacer` | Function | `Public Function AddSpacer(Optional id As String = "", Optional widthDip As Single = 8.0, Optional alignment As MASToolbarItemAlignment = MASToolbarItemAlignment.Left) As MASToolbarSpacer` |
| `AddSplitCommand` | Function | `Public Function AddSplitCommand(commandId As String, text As String, configureMenu As Action(Of MASDropDownMenuBuilder), Optional description As String = "", Optional primaryAction As Action(Of MASSplitButton) = Nothing, Optional intent As MASButtonIntent = MASButtonIntent.Default, Optional widthDip As Single = 0.0, Optional alignment As MASToolbarItemAlignment = MASToolbarItemAlignment.Left) As MASSplitButton` |
| `ClearItems` | Sub | `Public Sub ClearItems()` |
| `Create` | Function | `Public Shared Function Create() As MASToolbar` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASToolbar` |
| `WithSurfaceMaterial` | Function | `Public Function WithSurfaceMaterial(materialKey As String) As MASToolbar` |
| `SurfaceMaterial` | Property | `Public Property SurfaceMaterial As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASToolbarButtonClickedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Reusable/Toolbar/MASToolbar.vb:76` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Carries typed event data for Toolbar Button Clicked Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Control` | Property | `Public ReadOnly Property Control As MASControlBase` |
| `Id` | Property | `Public ReadOnly Property Id As String` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASToolbarSeparator`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Reusable/Toolbar/MASToolbarSeparator.vb:15` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Toolbar Separator component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASToolbarSeparator` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASToolbarSpacer`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Reusable/Toolbar/MASToolbarSpacer.vb:14` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Toolbar Spacer component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASToolbarSpacer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTopBarCommandEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/TopBar/MASTopBarCommandEventArgs.vb:8` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed event data for Top Bar Command Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CommandId` | Property | `Public ReadOnly Property CommandId As String` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASTopBarComponent`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/TopBar/MASTopBarComponent.vb:25` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** An advanced top-bar/chrome component.

**When to use it.** Use it for application chrome scenarios controlled by the Nexamas application/window route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `MenuCommandInvoked` | Event | `Public Event MenuCommandInvoked As EventHandler(Of MASTopBarCommandEventArgs)` |
| `WindowCommandInvoked` | Event | `Public Event WindowCommandInvoked As EventHandler(Of MASTopBarWindowCommandEventArgs)` |
| `Create` | Function | `Public Shared Function Create() As MASTopBarComponent` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `WithLogo` | Function | `Public Function WithLogo(Optional visible As Boolean = True) As MASTopBarComponent` |
| `WithMenuLottie` | Function | `Public Function WithMenuLottie(asm As System.Reflection.Assembly, resourceName As String) As MASTopBarComponent` |
| `WithMenu` | Function | `Public Function WithMenu(model As MASDropDownMenuModel) As MASTopBarComponent` |
| `WithMenu` | Function | `Public Function WithMenu(configure As Action(Of MASDropDownMenuBuilder)) As MASTopBarComponent` |
| `WithNativeWindowDrag` | Function | `Public Function WithNativeWindowDrag(Optional enabled As Boolean = True) As MASTopBarComponent` |
| `WithStandardWindowCommands` | Function | `Public Function WithStandardWindowCommands(Optional enabled As Boolean = True) As MASTopBarComponent` |
| `WithSurfaceMaterial` | Function | `Public Function WithSurfaceMaterial(materialKey As String) As MASTopBarComponent` |
| `WithTitle` | Function | `Public Function WithTitle(text As String) As MASTopBarComponent` |
| `WithoutLogo` | Function | `Public Function WithoutLogo() As MASTopBarComponent` |
| `WithoutNativeWindowDrag` | Function | `Public Function WithoutNativeWindowDrag() As MASTopBarComponent` |
| `WithoutStandardWindowCommands` | Function | `Public Function WithoutStandardWindowCommands() As MASTopBarComponent` |
| `EnableNativeWindowDrag` | Property | `Public Property EnableNativeWindowDrag As Boolean` |
| `EnableStandardWindowCommands` | Property | `Public Property EnableStandardWindowCommands As Boolean` |
| `MenuModel` | Property | `Public Property MenuModel As MASDropDownMenuModel` |
| `ShowLogo` | Property | `Public Property ShowLogo As Boolean` |
| `SurfaceMaterial` | Property | `Public Property SurfaceMaterial As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTopBarWindowCommandEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/TopBar/MASTopBarWindowCommandEventArgs.vb:8` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Carries typed event data for Top Bar Window Command Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Command` | Property | `Public ReadOnly Property Command As MASTopBarWindowCommand` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASTransferList`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/TransferList/MASTransferList.Events.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.Filtering.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.Geometry.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.Interaction.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.ItemModel.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.Layout.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.Motion.vb:13`<br>`Component/Navigation/TransferList/MASTransferList.PointerState.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.Rendering.vb:22`<br>`Component/Navigation/TransferList/MASTransferList.vb:29` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Transfer List component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ItemsTransferred` | Event | `Public Event ItemsTransferred As EventHandler` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddAvailableItems` | Function | `Public Function AddAvailableItems(items As IEnumerable(Of String)) As MASTransferList` |
| `AddAvailableItem` | Function | `Public Function AddAvailableItem(text As String) As MASTransferList` |
| `ClearFilters` | Function | `Public Function ClearFilters() As MASTransferList` |
| `ClearItems` | Function | `Public Function ClearItems() As MASTransferList` |
| `Create` | Function | `Public Shared Function Create(Optional availableItems As IEnumerable(Of String) = Nothing, Optional selectedItems As IEnumerable(Of String) = Nothing) As MASTransferList` |
| `MoveAllToAvailable` | Function | `Public Function MoveAllToAvailable() As MASTransferList` |
| `MoveAllToTarget` | Function | `Public Function MoveAllToTarget() As MASTransferList` |
| `MoveSelectedToTarget` | Function | `Public Function MoveSelectedToTarget() As MASTransferList` |
| `MoveTargetToAvailable` | Function | `Public Function MoveTargetToAvailable() As MASTransferList` |
| `SelectAvailableIndex` | Function | `Public Function SelectAvailableIndex(index As Integer) As MASTransferList` |
| `SelectSelectedIndex` | Function | `Public Function SelectSelectedIndex(index As Integer) As MASTransferList` |
| `SetAvailableItems` | Function | `Public Function SetAvailableItems(items As IEnumerable(Of String)) As MASTransferList` |
| `SetItems` | Function | `Public Function SetItems(availableItems As IEnumerable(Of String), selectedItems As IEnumerable(Of String)) As MASTransferList` |
| `SetSelectedItems` | Function | `Public Function SetSelectedItems(items As IEnumerable(Of String)) As MASTransferList` |
| `WithAvailableFilter` | Function | `Public Function WithAvailableFilter(value As String) As MASTransferList` |
| `WithAvailableItems` | Function | `Public Function WithAvailableItems(items As IEnumerable(Of String)) As MASTransferList` |
| `WithPanelTitles` | Function | `Public Function WithPanelTitles(availableTitle As String, selectedTitle As String) As MASTransferList` |
| `WithSelectedFilter` | Function | `Public Function WithSelectedFilter(value As String) As MASTransferList` |
| `WithSelectedItems` | Function | `Public Function WithSelectedItems(items As IEnumerable(Of String)) As MASTransferList` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTransferList` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASTransferList` |
| `AvailableCount` | Property | `Public ReadOnly Property AvailableCount As Integer` |
| `AvailableFilterText` | Property | `Public Property AvailableFilterText As String` |
| `AvailableItems` | Property | `Public ReadOnly Property AvailableItems As IReadOnlyList(Of String)` |
| `AvailableSelectedIndex` | Property | `Public Property AvailableSelectedIndex As Integer` |
| `AvailableTitle` | Property | `Public Property AvailableTitle As String` |
| `SelectedCount` | Property | `Public ReadOnly Property SelectedCount As Integer` |
| `SelectedFilterText` | Property | `Public Property SelectedFilterText As String` |
| `SelectedItems` | Property | `Public ReadOnly Property SelectedItems As IReadOnlyList(Of String)` |
| `SelectedSelectedIndex` | Property | `Public Property SelectedSelectedIndex As Integer` |
| `SelectedTitle` | Property | `Public Property SelectedTitle As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTreeGrid`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/TreeGrid/MASTreeGrid.DataSource.vb:12`<br>`Component/Data/TreeGrid/MASTreeGrid.Editing.vb:11`<br>`Component/Data/TreeGrid/MASTreeGrid.Helpers.vb:22`<br>`Component/Data/TreeGrid/MASTreeGrid.Interaction.vb:22`<br>`Component/Data/TreeGrid/MASTreeGrid.Layout.vb:22`<br>`Component/Data/TreeGrid/MASTreeGrid.Motion.vb:9`<br>`Component/Data/TreeGrid/MASTreeGrid.Rendering.vb:22`<br>`Component/Data/TreeGrid/MASTreeGrid.RowWindow.vb:89`<br>`Component/Data/TreeGrid/MASTreeGrid.SortFilter.vb:11`<br>`Component/Data/TreeGrid/MASTreeGrid.vb:30` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Tree Grid component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `RowEditCanceled` | Event | `Public Event RowEditCanceled As EventHandler` |
| `RowEditCommitted` | Event | `Public Event RowEditCommitted As EventHandler` |
| `RowEditStarted` | Event | `Public Event RowEditStarted As EventHandler` |
| `RowExpandedChanged` | Event | `Public Event RowExpandedChanged As EventHandler` |
| `SelectedRowChanged` | Event | `Public Event SelectedRowChanged As EventHandler` |
| `TreeGridChanged` | Event | `Public Event TreeGridChanged As EventHandler` |
| `AddChildRow` | Function | `Public Function AddChildRow(parentRowKey As String, rowKey As String, label As String, Optional values As IEnumerable(Of String) = Nothing, Optional expanded As Boolean = True) As MASTreeGrid` |
| `AddColumn` | Function | `Public Function AddColumn(columnKey As String, header As String, Optional widthWeight As Single = 1.0) As MASTreeGrid` |
| `AddRootRow` | Function | `Public Function AddRootRow(rowKey As String, label As String, Optional values As IEnumerable(Of String) = Nothing, Optional expanded As Boolean = True) As MASTreeGrid` |
| `BeginEditSelectedLabel` | Function | `Public Function BeginEditSelectedLabel() As Boolean` |
| `BeginEditSelectedValue` | Function | `Public Function BeginEditSelectedValue(columnKey As String) As Boolean` |
| `BeginEdit` | Function | `Public Function BeginEdit(rowKey As String, Optional columnKey As String = Nothing) As Boolean` |
| `CanEditRow` | Function | `Public Function CanEditRow(rowKey As String) As Boolean` |
| `CancelEdit` | Function | `Public Function CancelEdit() As Boolean` |
| `ClearColumns` | Function | `Public Function ClearColumns() As MASTreeGrid` |
| `ClearRowFilter` | Function | `Public Function ClearRowFilter() As MASTreeGrid` |
| `ClearRowSort` | Function | `Public Function ClearRowSort() As MASTreeGrid` |
| `ClearRows` | Function | `Public Function ClearRows() As MASTreeGrid` |
| `CommitEdit` | Function | `Public Function CommitEdit(Optional value As String = Nothing) As Boolean` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASTreeGrid` |
| `EnsureRowVisible` | Function | `Public Function EnsureRowVisible(rowKey As String) As Boolean` |
| `FilterRows` | Function | `Public Function FilterRows(filterText As String) As MASTreeGrid` |
| `GetColumnKeys` | Function | `Public Function GetColumnKeys() As IReadOnlyList(Of String)` |
| `GetRowKeys` | Function | `Public Function GetRowKeys() As IReadOnlyList(Of String)` |
| `GetRowLabel` | Function | `Public Function GetRowLabel(rowKey As String) As String` |
| `GetRowValues` | Function | `Public Function GetRowValues(rowKey As String) As IReadOnlyList(Of String)` |
| `GetRowValue` | Function | `Public Function GetRowValue(rowKey As String, columnKey As String) As String` |
| `ScrollRows` | Function | `Public Function ScrollRows(deltaRows As Integer) As Boolean` |
| `SelectRow` | Function | `Public Function SelectRow(rowKey As String) As Boolean` |
| `SetRowExpanded` | Function | `Public Function SetRowExpanded(rowKey As String, expanded As Boolean) As Boolean` |
| `SortRowsByColumn` | Function | `Public Function SortRowsByColumn(columnKey As String, Optional ascending As Boolean = True) As Boolean` |
| `SortRowsByLabel` | Function | `Public Function SortRowsByLabel(Optional ascending As Boolean = True) As MASTreeGrid` |
| `ToggleRow` | Function | `Public Function ToggleRow(rowKey As String) As Boolean` |
| `TrySetRowLabel` | Function | `Public Function TrySetRowLabel(rowKey As String, label As String) As Boolean` |
| `TrySetRowValue` | Function | `Public Function TrySetRowValue(rowKey As String, columnKey As String, value As String) As Boolean` |
| `UpdateEditDraft` | Function | `Public Function UpdateEditDraft(value As String) As Boolean` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTreeGrid` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASTreeGrid` |
| `ColumnCount` | Property | `Public ReadOnly Property ColumnCount As Integer` |
| `EditRevision` | Property | `Public ReadOnly Property EditRevision As Integer` |
| `EditingColumnKey` | Property | `Public ReadOnly Property EditingColumnKey As String` |
| `EditingDraftText` | Property | `Public ReadOnly Property EditingDraftText As String` |
| `EditingOriginalText` | Property | `Public ReadOnly Property EditingOriginalText As String` |
| `EditingRowKey` | Property | `Public ReadOnly Property EditingRowKey As String` |
| `FirstVisibleRowIndex` | Property | `Public ReadOnly Property FirstVisibleRowIndex As Integer` |
| `HasRowFilter` | Property | `Public ReadOnly Property HasRowFilter As Boolean` |
| `IsEditingLabel` | Property | `Public ReadOnly Property IsEditingLabel As Boolean` |
| `IsEditingRow` | Property | `Public ReadOnly Property IsEditingRow As Boolean` |
| `IsSorted` | Property | `Public ReadOnly Property IsSorted As Boolean` |
| `LastVisibleRowIndex` | Property | `Public ReadOnly Property LastVisibleRowIndex As Integer` |
| `RowCount` | Property | `Public ReadOnly Property RowCount As Integer` |
| `RowFilterText` | Property | `Public ReadOnly Property RowFilterText As String` |
| `RowViewportCapacity` | Property | `Public ReadOnly Property RowViewportCapacity As Integer` |
| `SelectedRowKey` | Property | `Public ReadOnly Property SelectedRowKey As String` |
| `SortAscending` | Property | `Public ReadOnly Property SortAscending As Boolean` |
| `SortColumnKey` | Property | `Public ReadOnly Property SortColumnKey As String` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |
| `VisibleRowCount` | Property | `Public ReadOnly Property VisibleRowCount As Integer` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTreeNode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/Tree/Core/MASTreeNode.vb:13` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides a typed model/DTO used by the Tree Node control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `AddChildren` | Function | `Public Function AddChildren(nodes As IEnumerable(Of MASTreeNode)) As MASTreeNode` |
| `AddChild` | Function | `Public Function AddChild(text As String) As MASTreeNode` |
| `AddChild` | Sub | `Public Sub AddChild(node As MASTreeNode)` |
| `Add` | Function | `Public Function Add(node As MASTreeNode) As MASTreeNode` |
| `Add` | Function | `Public Function Add(text As String) As MASTreeNode` |
| `ClearChildren` | Sub | `Public Sub ClearChildren()` |
| `Clear` | Function | `Public Function Clear() As MASTreeNode` |
| `Collapsed` | Function | `Public Function Collapsed() As MASTreeNode` |
| `Create` | Function | `Public Shared Function Create(text As String) As MASTreeNode` |
| `Expanded` | Function | `Public Function Expanded(Optional value As Boolean = True) As MASTreeNode` |
| `RemoveChild` | Function | `Public Function RemoveChild(node As MASTreeNode) As Boolean` |
| `WithTag` | Function | `Public Function WithTag(value As Object) As MASTreeNode` |
| `WithText` | Function | `Public Function WithText(text As String) As MASTreeNode` |
| `Children` | Property | `Public ReadOnly Property Children As IReadOnlyList(Of MASTreeNode)` |
| `HasChildren` | Property | `Public ReadOnly Property HasChildren As Boolean` |
| `IsExpanded` | Property | `Public Property IsExpanded As Boolean` |
| `Parent` | Property | `Public ReadOnly Property Parent As MASTreeNode` |
| `Tag` | Property | `Public Property Tag As Object` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTreeNodeCollection`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/Tree/MASTreeNodeCollection.vb:12` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides a typed model/DTO used by the Tree Node Collection control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Add` | Function | `Public Function Add(text As String) As MASTreeNode` |
| `Add` | Sub | `Public Sub Add(node As MASTreeNode)` |
| `Clear` | Sub | `Public Sub Clear()` |
| `Contains` | Function | `Public Function Contains(node As MASTreeNode) As Boolean` |
| `GetEnumerator` | Function | `Public Function GetEnumerator() As IEnumerator(Of MASTreeNode)` |
| `IndexOf` | Function | `Public Function IndexOf(node As MASTreeNode) As Integer` |
| `Remove` | Function | `Public Function Remove(node As MASTreeNode) As Boolean` |
| `Count` | Property | `Public ReadOnly Property Count As Integer` |
| `Item` | Property | `Default Public ReadOnly Property Item(index1 As Integer) As MASTreeNode` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASTreeView`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/Tree/Core/MASTreeView.Api.vb:27`<br>`Component/Navigation/Tree/Core/MASTreeView.Helpers.vb:27`<br>`Component/Navigation/Tree/Core/MASTreeView.IconResolverLifecycle.vb:26`<br>`Component/Navigation/Tree/Core/MASTreeView.Input.vb:26`<br>`Component/Navigation/Tree/Core/MASTreeView.Lifetime.vb:27`<br>`Component/Navigation/Tree/Core/MASTreeView.Measurement.vb:26`<br>`Component/Navigation/Tree/Core/MASTreeView.Nodes.vb:27`<br>`Component/Navigation/Tree/Core/MASTreeView.Rendering.vb:27`<br>`Component/Navigation/Tree/Core/MASTreeView.vb:30` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Tree View component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `NodeActivated` | Event | `Public Event NodeActivated As EventHandler` |
| `NodeExpandedChanged` | Event | `Public Event NodeExpandedChanged As EventHandler` |
| `SelectedNodeChanged` | Event | `Public Event SelectedNodeChanged As EventHandler` |
| `AddRootFluent` | Function | `Public Function AddRootFluent(node As MASTreeNode) As MASTreeView` |
| `AddRootFluent` | Function | `Public Function AddRootFluent(text As String) As MASTreeView` |
| `AddRoot` | Function | `Public Function AddRoot(text As String) As MASTreeNode` |
| `AddRoot` | Sub | `Public Sub AddRoot(node As MASTreeNode)` |
| `ClearNodes` | Sub | `Public Sub ClearNodes()` |
| `ClearSelection` | Function | `Public Function ClearSelection() As MASTreeView` |
| `Clear` | Function | `Public Function Clear() As MASTreeView` |
| `Create` | Function | `Public Shared Function Create() As MASTreeView` |
| `RemoveRoot` | Function | `Public Function RemoveRoot(node As MASTreeNode) As Boolean` |
| `SelectNode` | Function | `Public Function SelectNode(node As MASTreeNode) As MASTreeView` |
| `SetIconResolver` | Sub | `Public Sub SetIconResolver(resolver As IMASIconResolver, ownsResolver As Boolean)` |
| `WithIconResolver` | Function | `Public Function WithIconResolver(resolver As IMASIconResolver, Optional ownsResolver As Boolean = False) As MASTreeView` |
| `WithIconSizeMode` | Function | `Public Function WithIconSizeMode(mode As MASListTreeIconSizeMode) As MASTreeView` |
| `WithNodeIconSize` | Function | `Public Function WithNodeIconSize(valueDip As Single) As MASTreeView` |
| `WithNodeIcons` | Function | `Public Function WithNodeIcons(Optional visible As Boolean = True) As MASTreeView` |
| `WithRoots` | Function | `Public Function WithRoots(nodes As IEnumerable(Of MASTreeNode)) As MASTreeView` |
| `WithRowHeight` | Function | `Public Function WithRowHeight(valueDip As Single) As MASTreeView` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTreeView` |
| `WithoutNodeIcons` | Function | `Public Function WithoutNodeIcons() As MASTreeView` |
| `IconResolver` | Property | `Public Property IconResolver As IMASIconResolver` |
| `IconSizeMode` | Property | `Public Property IconSizeMode As MASListTreeIconSizeMode` |
| `NodeIconSizeDip` | Property | `Public Property NodeIconSizeDip As Single` |
| `Nodes` | Property | `Public ReadOnly Property Nodes As MASTreeNodeCollection` |
| `RowHeightDip` | Property | `Public Property RowHeightDip As Single` |
| `SelectedNode` | Property | `Public Property SelectedNode As MASTreeNode` |
| `ShowNodeIcons` | Property | `Public Property ShowNodeIcons As Boolean` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASAgendaViewMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/AgendaView/MASAgendaViewMode.vb:11` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Defines option values for the Agenda View Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Day` | Enum value | `Day = 0` |
| `Month` | Enum value | `Month = 2` |
| `Week` | Enum value | `Week = 1` |

**Minimal usage shape.**

```vb
' Pass MASAgendaViewMode values only to APIs that explicitly accept this enum.
```

### `MASButtonPersonality`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Buttons/MASButton/Model/MASButtonPersonality.vb:10` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Button Personality API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `MAS` | Enum value | `MAS = 0` |
| `Tal` | Enum value | `Tal = 1` |

**Minimal usage shape.**

```vb
' Pass MASButtonPersonality values only to APIs that explicitly accept this enum.
```

### `MASColorPickerSlot`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Editor/ColorPicker/MASColorPickerSlot.vb:6` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Color Picker Slot API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Primary` | Enum value | `Primary = 0` |
| `Secondary` | Enum value | `Secondary = 1` |

**Minimal usage shape.**

```vb
' Pass MASColorPickerSlot values only to APIs that explicitly accept this enum.
```

### `MASDataFormFieldKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/DataForm/MASDataFormFieldKind.vb:11` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Data Form Field Kind API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Custom` | Enum value | `Custom = 99` |
| `DateRange` | Enum value | `DateRange = 5` |
| `Date` | Enum value | `Date = 4` |
| `Number` | Enum value | `Number = 1` |
| `Selection` | Enum value | `Selection = 2` |
| `Tags` | Enum value | `Tags = 6` |
| `Text` | Enum value | `Text = 0` |
| `Toggle` | Enum value | `Toggle = 3` |

**Minimal usage shape.**

```vb
' Pass MASDataFormFieldKind values only to APIs that explicitly accept this enum.
```

### `MASDataFormFieldState`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Inputs/DataForm/MASDataFormFieldState.vb:10` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Data Form Field State API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Disabled` | Enum value | `Disabled = 5` |
| `Error` | Enum value | `Error = 4` |
| `Normal` | Enum value | `Normal = 0` |
| `ReadOnly` | Enum value | `ReadOnly = 6` |
| `Required` | Enum value | `Required = 1` |
| `Success` | Enum value | `Success = 2` |
| `Warning` | Enum value | `Warning = 3` |

**Minimal usage shape.**

```vb
' Pass MASDataFormFieldState values only to APIs that explicitly accept this enum.
```

### `MASDataGridSelectionMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Model/MASDataGridSelectionMode.vb:9` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Data Grid Selection Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Cell` | Enum value | `Cell = 2` |
| `None` | Enum value | `None = 0` |
| `Row` | Enum value | `Row = 1` |

**Minimal usage shape.**

```vb
' Pass MASDataGridSelectionMode values only to APIs that explicitly accept this enum.
```

### `MASDataGridSortDirection`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Model/MASDataGridSortDirection.vb:10` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Data Grid Sort Direction API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Ascending` | Enum value | `Ascending = 1` |
| `Descending` | Enum value | `Descending = 2` |
| `None` | Enum value | `None = 0` |

**Minimal usage shape.**

```vb
' Pass MASDataGridSortDirection values only to APIs that explicitly accept this enum.
```

### `MASDataGridSummaryFooterMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/DataGrid/Model/MASDataGridSummaryFooterMode.vb:11` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Data Grid Summary Footer Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Always` | Enum value | `Always = 1` |
| `Automatic` | Enum value | `Automatic = 0` |
| `Disabled` | Enum value | `Disabled = 2` |

**Minimal usage shape.**

```vb
' Pass MASDataGridSummaryFooterMode values only to APIs that explicitly accept this enum.
```

### `MASFileExplorerItemKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FileExplorer/Core/MASFileExplorerItemKind.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the File Explorer Item Kind API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `FileItem` | Enum value | `FileItem = 1` |
| `Folder` | Enum value | `Folder = 0` |

**Minimal usage shape.**

```vb
' Pass MASFileExplorerItemKind values only to APIs that explicitly accept this enum.
```

### `MASFileExplorerLocationKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/FileExplorer/Core/MASFileExplorerLocationKind.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the File Explorer Location Kind API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `DriveRoot` | Enum value | `DriveRoot = 2` |
| `FileItem` | Enum value | `FileItem = 5` |
| `Folder` | Enum value | `Folder = 4` |
| `SpecialFolder` | Enum value | `SpecialFolder = 3` |
| `Unknown` | Enum value | `Unknown = 0` |
| `VirtualRoot` | Enum value | `VirtualRoot = 1` |

**Minimal usage shape.**

```vb
' Pass MASFileExplorerLocationKind values only to APIs that explicitly accept this enum.
```

### `MASFilterOperator`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Data/FilterBuilder/MASFilterRule.vb:66` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Defines option values for the Filter Operator API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Contains` | Enum value | `Contains = 2` |
| `EndsWith` | Enum value | `EndsWith = 4` |
| `Equals` | Enum value | `Equals = 0` |
| `GreaterOrEqual` | Enum value | `GreaterOrEqual = 6` |
| `GreaterThan` | Enum value | `GreaterThan = 5` |
| `IsEmpty` | Enum value | `IsEmpty = 9` |
| `IsNotEmpty` | Enum value | `IsNotEmpty = 10` |
| `LessOrEqual` | Enum value | `LessOrEqual = 8` |
| `LessThan` | Enum value | `LessThan = 7` |
| `NotEquals` | Enum value | `NotEquals = 1` |
| `StartsWith` | Enum value | `StartsWith = 3` |

**Minimal usage shape.**

```vb
' Pass MASFilterOperator values only to APIs that explicitly accept this enum.
```

### `MASImageExportFormat`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Media/ImageViewer/MASImageExportFormat.vb:10` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Defines option values for the Image Export Format API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Jpeg` | Enum value | `Jpeg = 1` |
| `Png` | Enum value | `Png = 0` |
| `Webp` | Enum value | `Webp = 2` |

**Minimal usage shape.**

```vb
' Pass MASImageExportFormat values only to APIs that explicitly accept this enum.
```

### `MASImageViewerChromeMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Media/ImageViewer/MASImageViewerChromeMode.vb:11` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Defines option values for the Image Viewer Chrome Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AutoHide` | Enum value | `AutoHide = 0` |
| `Hidden` | Enum value | `Hidden = 2` |
| `Pinned` | Enum value | `Pinned = 1` |

**Minimal usage shape.**

```vb
' Pass MASImageViewerChromeMode values only to APIs that explicitly accept this enum.
```

### `MASListViewChromeMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Rendering/MASListViewChromeMode.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the List View Chrome Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Embedded` | Enum value | `Embedded = 1` |
| `Standalone` | Enum value | `Standalone = 0` |
| `Transparent` | Enum value | `Transparent = 2` |

**Minimal usage shape.**

```vb
' Pass MASListViewChromeMode values only to APIs that explicitly accept this enum.
```

### `MASListViewColumnTextAlign`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Core/MASListViewColumn.vb:8` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the List View Column Text Align API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Center` | Enum value | `Center = 1` |
| `Left` | Enum value | `Left = 0` |
| `Right` | Enum value | `Right = 2` |

**Minimal usage shape.**

```vb
' Pass MASListViewColumnTextAlign values only to APIs that explicitly accept this enum.
```

### `MASListViewItemKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Core/MASListViewItem.vb:11` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the List View Item Kind API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `GroupHeader` | Enum value | `GroupHeader = 1` |
| `Normal` | Enum value | `Normal = 0` |

**Minimal usage shape.**

```vb
' Pass MASListViewItemKind values only to APIs that explicitly accept this enum.
```

### `MASListViewMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Core/MASListViewMode.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the List View Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Details` | Enum value | `Details = 0` |
| `LargeIcon` | Enum value | `LargeIcon = 2` |
| `List` | Enum value | `List = 1` |
| `Tiles` | Enum value | `Tiles = 3` |

**Minimal usage shape.**

```vb
' Pass MASListViewMode values only to APIs that explicitly accept this enum.
```

### `MASListViewSortDirection`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/List/ListView/Core/MASListViewSortDirection.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the List View Sort Direction API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Ascending` | Enum value | `Ascending = 1` |
| `Descending` | Enum value | `Descending = 2` |
| `None` | Enum value | `None = 0` |

**Minimal usage shape.**

```vb
' Pass MASListViewSortDirection values only to APIs that explicitly accept this enum.
```

### `MASProgressBarState`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Feedback/ProgressBar/ProgressBarVisualState.vb:10` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines option values for the Progress Bar State API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Danger` | Enum value | `Danger = 3` |
| `Normal` | Enum value | `Normal = 0` |
| `Success` | Enum value | `Success = 1` |
| `Warning` | Enum value | `Warning = 2` |

**Minimal usage shape.**

```vb
' Pass MASProgressBarState values only to APIs that explicitly accept this enum.
```

### `MASSelectorItemGlyphKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Selectors/SelectorItem/MASSelectorItemEntry.vb:49` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Selector Item Glyph Kind API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `All` | Enum value | `All = 0` |
| `Communication` | Enum value | `Communication = 4` |
| `Devices` | Enum value | `Devices = 7` |
| `Files` | Enum value | `Files = 2` |
| `Media` | Enum value | `Media = 3` |
| `Network` | Enum value | `Network = 6` |
| `Security` | Enum value | `Security = 5` |
| `System` | Enum value | `System = 8` |
| `UI` | Enum value | `UI = 1` |
| `Unsorted` | Enum value | `Unsorted = 9` |

**Minimal usage shape.**

```vb
' Pass MASSelectorItemGlyphKind values only to APIs that explicitly accept this enum.
```

### `MASTimelineItemState`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Feedback/Timeline/MASTimelineItemState.vb:11` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Timeline Item State API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Completed` | Enum value | `Completed = 1` |
| `Current` | Enum value | `Current = 2` |
| `Disabled` | Enum value | `Disabled = 5` |
| `Error` | Enum value | `Error = 4` |
| `Normal` | Enum value | `Normal = 0` |
| `Warning` | Enum value | `Warning = 3` |

**Minimal usage shape.**

```vb
' Pass MASTimelineItemState values only to APIs that explicitly accept this enum.
```

### `MASToolbarItemAlignment`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Reusable/Toolbar/MASToolbarItemAlignment.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the Toolbar Item Alignment API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Left` | Enum value | `Left = 0` |
| `Right` | Enum value | `Right = 1` |

**Minimal usage shape.**

```vb
' Pass MASToolbarItemAlignment values only to APIs that explicitly accept this enum.
```

### `MASToolbarItemSizing`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Reusable/Toolbar/MASToolbarItemSizing.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the Toolbar Item Sizing API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Fill` | Enum value | `Fill = 1` |
| `Fixed` | Enum value | `Fixed = 0` |

**Minimal usage shape.**

```vb
' Pass MASToolbarItemSizing values only to APIs that explicitly accept this enum.
```

### `MASTopBarWindowCommand`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Navigation/TopBar/MASTopBarWindowCommand.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the Top Bar Window Command API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `CloseWindow` | Enum value | `CloseWindow = 3` |
| `Minimize` | Enum value | `Minimize = 1` |
| `None` | Enum value | `None = 0` |
| `ToggleMaximizeRestore` | Enum value | `ToggleMaximizeRestore = 2` |

**Minimal usage shape.**

```vb
' Pass MASTopBarWindowCommand values only to APIs that explicitly accept this enum.
```

## `Nexamas.UI.Components.DropDownMenu`

### `MASDropDownMenuBuilder`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components.DropDownMenu` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Menus/Reusable/Core/MASDropDownMenuBuilder.vb:9` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the advanced Drop Down Menu Builder component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Action` | Function | `Public Function Action(text As String, commandId As String, Optional handler As Action = Nothing, Optional isChecked As Boolean = False, Optional enabled As Boolean = True, Optional shortcutText As String = "", Optional intent As MASDropDownMenuItemIntent = MASDropDownMenuItemIntent.Default) As MASDropDownMenuBuilder` |
| `AddAction` | Function | `Public Function AddAction(text As String, commandId As String, Optional handler As Action = Nothing, Optional enabled As Boolean = True, Optional shortcutText As String = "", Optional intent As MASDropDownMenuItemIntent = MASDropDownMenuItemIntent.Default) As MASDropDownMenuBuilder` |
| `AddCheckedAction` | Function | `Public Function AddCheckedAction(text As String, commandId As String, Optional handler As Action = Nothing, Optional isChecked As Boolean = True, Optional enabled As Boolean = True, Optional shortcutText As String = "") As MASDropDownMenuBuilder` |
| `AddDangerAction` | Function | `Public Function AddDangerAction(text As String, commandId As String, Optional handler As Action = Nothing, Optional enabled As Boolean = True, Optional shortcutText As String = "") As MASDropDownMenuBuilder` |
| `AddSeparator` | Function | `Public Function AddSeparator() As MASDropDownMenuBuilder` |
| `AddSubMenu` | Function | `Public Function AddSubMenu(text As String, configure As Action(Of MASDropDownMenuBuilder), Optional enabled As Boolean = True) As MASDropDownMenuBuilder` |
| `Build` | Function | `Public Function Build() As MASDropDownMenuModel` |
| `CreateCommandExecutor` | Function | `Public Function CreateCommandExecutor(Optional fallback As Action(Of String) = Nothing) As Action(Of String)` |
| `Create` | Function | `Public Shared Function Create() As MASDropDownMenuBuilder` |
| `Separator` | Function | `Public Function Separator() As MASDropDownMenuBuilder` |
| `SubMenu` | Function | `Public Function SubMenu(text As String, configure As Action(Of MASDropDownMenuBuilder), Optional enabled As Boolean = True) As MASDropDownMenuBuilder` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDropDownMenuModel`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components.DropDownMenu` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Menus/Reusable/Core/MASDropDownMenuModel.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides a typed model/DTO used by the Drop Down Menu Model control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(rootNode As MASDropDownMenuNode)` |
| `New` | Sub | `Public Sub New()` |
| `IsEmpty` | Property | `Public ReadOnly Property IsEmpty As Boolean` |
| `Root` | Property | `Public ReadOnly Property Root As MASDropDownMenuNode` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDropDownMenuNode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components.DropDownMenu` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Menus/Reusable/Core/MASDropDownMenuNode.vb:19` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides a typed model/DTO used by the Drop Down Menu Node control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Action` | Function | `Public Shared Function Action(text As String, commandId As String, Optional isChecked As Boolean = False, Optional enabled As Boolean = True, Optional shortcutText As String = "", Optional tag As Object = Nothing, Optional intent As MASDropDownMenuItemIntent = MASDropDownMenuItemIntent.Default) As MASDropDownMenuNode` |
| `HasChildren` | Function | `Public Function HasChildren() As Boolean` |
| `Root` | Function | `Public Shared Function Root(children As MASDropDownMenuNode()) As MASDropDownMenuNode` |
| `Separator` | Function | `Public Shared Function Separator() As MASDropDownMenuNode` |
| `SubMenu` | Function | `Public Shared Function SubMenu(text As String, children As MASDropDownMenuNode()) As MASDropDownMenuNode` |
| `Children` | Property | `Public ReadOnly Property Children As IReadOnlyList(Of MASDropDownMenuNode)` |
| `CommandId` | Property | `Public ReadOnly Property CommandId As String` |
| `Enabled` | Property | `Public ReadOnly Property Enabled As Boolean` |
| `Intent` | Property | `Public ReadOnly Property Intent As MASDropDownMenuItemIntent` |
| `IsChecked` | Property | `Public ReadOnly Property IsChecked As Boolean` |
| `Kind` | Property | `Public ReadOnly Property Kind As MASDropDownMenuNodeKind` |
| `ShortcutText` | Property | `Public ReadOnly Property ShortcutText As String` |
| `Tag` | Property | `Public ReadOnly Property Tag As Object` |
| `Text` | Property | `Public ReadOnly Property Text As String` |
| `Visible` | Property | `Public ReadOnly Property Visible As Boolean` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDropDownMenuItemIntent`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components.DropDownMenu` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Menus/Reusable/Core/MASDropDownMenuItemIntent.vb:6` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the Drop Down Menu Item Intent API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Danger` | Enum value | `Danger = 1` |
| `Default` | Enum value | `Default = 0` |

**Minimal usage shape.**

```vb
' Pass MASDropDownMenuItemIntent values only to APIs that explicitly accept this enum.
```

### `MASDropDownMenuNodeKind`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Components.DropDownMenu` |
| Kind | `Enum` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `Component/Menus/Reusable/Core/MASDropDownMenuNode.vb:12` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the Drop Down Menu Node Kind API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ActionItem` | Enum value | `ActionItem = 1` |
| `Root` | Enum value | `Root = 0` |
| `Separator` | Enum value | `Separator = 3` |
| `SubMenu` | Enum value | `SubMenu = 2` |

**Minimal usage shape.**

```vb
' Pass MASDropDownMenuNodeKind values only to APIs that explicitly accept this enum.
```

## `Nexamas.UI.Controls`

### `MASAccordion`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Container/Accordion/MASAccordion.Motion.vb:8`<br>`Component/Container/Accordion/MASAccordion.vb:22` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the stable Accordion control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ExpandedSectionChanged` | Event | `Public Event ExpandedSectionChanged As EventHandler` |
| `AddSection` | Function | `Public Function AddSection(title As String, Optional expanded As Boolean = True, Optional configure As Action(Of MASExpander) = Nothing) As MASExpander` |
| `ClearSections` | Function | `Public Function ClearSections() As MASAccordion` |
| `CollapseSection` | Sub | `Public Sub CollapseSection(index As Integer)` |
| `Create` | Function | `Public Shared Function Create(Optional allowMultipleExpanded As Boolean = False) As MASAccordion` |
| `ExpandSection` | Sub | `Public Sub ExpandSection(index As Integer)` |
| `GetSection` | Function | `Public Function GetSection(index As Integer) As MASExpander` |
| `RemoveSection` | Function | `Public Function RemoveSection(section As MASExpander) As MASAccordion` |
| `ToggleSection` | Sub | `Public Sub ToggleSection(index As Integer)` |
| `WithAllowMultipleExpanded` | Function | `Public Function WithAllowMultipleExpanded(value As Boolean) As MASAccordion` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASAccordion` |
| `AllowMultipleExpanded` | Property | `Public Property AllowMultipleExpanded As Boolean` |
| `ExpandedIndex` | Property | `Public ReadOnly Property ExpandedIndex As Integer` |
| `SectionCount` | Property | `Public ReadOnly Property SectionCount As Integer` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASBadge`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Badge/MASBadge.vb:23` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** A stable compact status/count marker.

**When to use it.** Use it for small counts, labels, or status chips attached to surrounding content.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing, Optional tone As MASToastTone = MASToastTone.Neutral) As MASBadge` |
| `WithDotOnly` | Function | `Public Function WithDotOnly(Optional value As Boolean = True) As MASBadge` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASBadge` |
| `WithText` | Function | `Public Function WithText(value As String) As MASBadge` |
| `WithTone` | Function | `Public Function WithTone(value As MASToastTone) As MASBadge` |
| `DotOnly` | Property | `Public Property DotOnly As Boolean` |
| `Text` | Property | `Public Property Text As String` |
| `Tone` | Property | `Public Property Tone As MASToastTone` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASButton`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Buttons/MASButton/Control/MASButton.Api.vb:20`<br>`Component/Buttons/MASButton/Control/MASButton.Helpers.vb:21`<br>`Component/Buttons/MASButton/Control/MASButton.Input.vb:20`<br>`Component/Buttons/MASButton/Control/MASButton.Lifetime.vb:20`<br>`Component/Buttons/MASButton/Control/MASButton.Rendering.vb:20`<br>`Component/Buttons/MASButton/Control/MASButton.State.vb:20`<br>`Component/Buttons/MASButton/Control/MASButton.vb:32` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** A clickable action control for primary, secondary, and icon-assisted commands.

**When to use it.** Use it for consumer actions such as Save, Cancel, Apply, or command-bar actions, preferably through `window.Controls.AddButton(...)` when available.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `BusyChanged` | Event | `Public Event BusyChanged As EventHandler` |
| `Click` | Event | `Public Event Click As EventHandler` |
| `CommandChanged` | Event | `Public Event CommandChanged As EventHandler` |
| `DefaultButtonChanged` | Event | `Public Event DefaultButtonChanged As EventHandler` |
| `IconChanged` | Event | `Public Event IconChanged As EventHandler` |
| `IntentChanged` | Event | `Public Event IntentChanged As EventHandler` |
| `PersonalityChanged` | Event | `Public Event PersonalityChanged As EventHandler` |
| `SelectedChanged` | Event | `Public Event SelectedChanged As EventHandler` |
| `SizeHintsChanged` | Event | `Public Event SizeHintsChanged As EventHandler` |
| `TooltipChanged` | Event | `Public Event TooltipChanged As EventHandler` |
| `AsDanger` | Function | `Public Function AsDanger() As MASButton` |
| `AsDefaultAction` | Function | `Public Function AsDefaultAction() As MASButton` |
| `AsDefault` | Function | `Public Function AsDefault() As MASButton` |
| `AsMAS` | Function | `Public Function AsMAS() As MASButton` |
| `AsPrimary` | Function | `Public Function AsPrimary() As MASButton` |
| `AsSelected` | Function | `Public Function AsSelected() As MASButton` |
| `AsSubtle` | Function | `Public Function AsSubtle() As MASButton` |
| `AsTal` | Function | `Public Function AsTal() As MASButton` |
| `CanActivate` | Function | `Public Function CanActivate() As Boolean` |
| `ClearBusy` | Sub | `Public Sub ClearBusy()` |
| `ClearIcon` | Sub | `Public Sub ClearIcon()` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASButton` |
| `DeselectButton` | Sub | `Public Sub DeselectButton()` |
| `PerformClick` | Sub | `Public Sub PerformClick()` |
| `SelectButton` | Sub | `Public Sub SelectButton()` |
| `SetBusy` | Sub | `Public Sub SetBusy(Optional value As Boolean = True, Optional busyText As String = Nothing)` |
| `SetIcon` | Sub | `Public Sub SetIcon(drawIcon As Action(Of SKCanvas, SKRect, Single, SKColor), Optional drawIconEmphasis As Action(Of SKCanvas, SKRect, Single, SKColor) = Nothing)` |
| `WithBusyText` | Function | `Public Function WithBusyText(value As String) As MASButton` |
| `WithBusy` | Function | `Public Function WithBusy(Optional value As Boolean = True, Optional busyText As String = Nothing) As MASButton` |
| `WithCommand` | Function | `Public Function WithCommand(action As Action(Of MASButton)) As MASButton` |
| `WithDefaultButton` | Function | `Public Function WithDefaultButton(Optional value As Boolean = True) As MASButton` |
| `WithDisableWhileBusy` | Function | `Public Function WithDisableWhileBusy(Optional value As Boolean = True) As MASButton` |
| `WithIconPlacement` | Function | `Public Function WithIconPlacement(value As MASButtonIconPlacement) As MASButton` |
| `WithIcon` | Function | `Public Function WithIcon(drawIcon As Action(Of SKCanvas, SKRect, Single, SKColor), Optional drawIconEmphasis As Action(Of SKCanvas, SKRect, Single, SKColor) = Nothing) As MASButton` |
| `WithIntent` | Function | `Public Function WithIntent(value As MASButtonIntent) As MASButton` |
| `WithPersonality` | Function | `Public Function WithPersonality(value As MASButtonPersonality) As MASButton` |
| `WithSelected` | Function | `Public Function WithSelected(Optional value As Boolean = True) As MASButton` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASButton` |
| `WithText` | Function | `Public Function WithText(value As String) As MASButton` |
| `WithTooltip` | Function | `Public Function WithTooltip(value As String) As MASButton` |
| `WithoutIcon` | Function | `Public Function WithoutIcon() As MASButton` |
| `BusyText` | Property | `Public Property BusyText As String` |
| `Command` | Property | `Public Property Command As Action(Of MASButton)` |
| `Default` | Property | `Public Property Default As Boolean` |
| `DisableWhileBusy` | Property | `Public Property DisableWhileBusy As Boolean` |
| `EffectiveText` | Property | `Public ReadOnly Property EffectiveText As String` |
| `HasIcon` | Property | `Public ReadOnly Property HasIcon As Boolean` |
| `IconPlacement` | Property | `Public Property IconPlacement As MASButtonIconPlacement` |
| `Intent` | Property | `Public Property Intent As MASButtonIntent` |
| `IsBusy` | Property | `Public Property IsBusy As Boolean` |
| `IsDefaultButton` | Property | `Public Property IsDefaultButton As Boolean` |
| `IsSelected` | Property | `Public Property IsSelected As Boolean` |
| `Personality` | Property | `Public Property Personality As MASButtonPersonality` |
| `Text` | Property | `Public Property Text As String` |
| `Tooltip` | Property | `Public Property Tooltip As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASCallout`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Callout/MASCallout.Motion.vb:12`<br>`Component/Feedback/Callout/MASCallout.vb:23` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Callout control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional text As String = Nothing) As MASCallout` |
| `WithPlacement` | Function | `Public Function WithPlacement(value As MASCalloutPlacement) As MASCallout` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASCallout` |
| `WithText` | Function | `Public Function WithText(value As String) As MASCallout` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASCallout` |
| `Placement` | Property | `Public Property Placement As MASCalloutPlacement` |
| `Text` | Property | `Public Property Text As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASCard`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Surfaces/Cards/MASCard.vb:22` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** A stable container surface for grouped content.

**When to use it.** Use it to present a coherent block of information or controls with a Nexamas-owned surface treatment.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create() As MASCard` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASCard` |
| `WithSurfaceMaterial` | Function | `Public Function WithSurfaceMaterial(materialKey As String) As MASCard` |
| `WithVisualStyle` | Function | `Public Function WithVisualStyle(value As MASCardVisualStyle) As MASCard` |
| `SurfaceMaterial` | Property | `Public Property SurfaceMaterial As String` |
| `VisualStyle` | Property | `Public Property VisualStyle As MASCardVisualStyle` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASCommandPalette`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/CommandPalette/MASCommandPalette.Motion.vb:13`<br>`Component/Navigation/CommandPalette/MASCommandPalette.vb:27` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the stable Command Palette control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `CommandExecuted` | Event | `Public Event CommandExecuted As EventHandler` |
| `CommandsChanged` | Event | `Public Event CommandsChanged As EventHandler` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddCommand` | Function | `Public Function AddCommand(commandId As String, text As String, execute As Action, Optional canExecute As Func(Of Boolean) = Nothing, Optional category As String = Nothing, Optional description As String = Nothing) As MASCommandPalette` |
| `ClearCommands` | Function | `Public Function ClearCommands() As MASCommandPalette` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASCommandPalette` |
| `ExecuteSelectedCommand` | Function | `Public Function ExecuteSelectedCommand() As Boolean` |
| `RemoveCommand` | Function | `Public Function RemoveCommand(commandId As String) As MASCommandPalette` |
| `SelectNext` | Function | `Public Function SelectNext() As MASCommandPalette` |
| `SelectPrevious` | Function | `Public Function SelectPrevious() As MASCommandPalette` |
| `WithQuery` | Function | `Public Function WithQuery(value As String) As MASCommandPalette` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASCommandPalette` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASCommandPalette` |
| `CommandCount` | Property | `Public ReadOnly Property CommandCount As Integer` |
| `EmptyText` | Property | `Public Property EmptyText As String` |
| `PlaceholderText` | Property | `Public Property PlaceholderText As String` |
| `Query` | Property | `Public Property Query As String` |
| `ResultCount` | Property | `Public ReadOnly Property ResultCount As Integer` |
| `SelectedCommandId` | Property | `Public ReadOnly Property SelectedCommandId As String` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASControlBase`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Advanced` |
| V1 approval | `—` |
| Evidence | `MASSystem/Core/Framework/Controls/Core/MASControlBase.Children.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.Contract.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.GeometryHelpers.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.Hosting.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.InputRouting.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.Lifecycle.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.Properties.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.Rendering.vb:15`<br>`MASSystem/Core/Framework/Controls/Core/MASControlBase.vb:37` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the advanced Control Base component surface in Nexamas UI.

**When to use it.** Use it for product-level scenarios after reviewing recipes and ownership boundaries; it is not promoted as the default beginner route.

**Stability note.** Advanced surface is public but should be routed through documented owner APIs, recipes, or product-control guidance rather than promoted as the beginner path.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `BoundsChanged` | Event | `Public Event BoundsChanged As EventHandler` |
| `EnabledChanged` | Event | `Public Event EnabledChanged As EventHandler` |
| `GotFocus` | Event | `Public Event GotFocus As EventHandler` |
| `LostFocus` | Event | `Public Event LostFocus As EventHandler` |
| `TextChanged` | Event | `Public Event TextChanged As EventHandler` |
| `VisibleChanged` | Event | `Public Event VisibleChanged As EventHandler` |
| `Detach` | Sub | `Public Sub Detach()` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `SetSize` | Function | `Public Function SetSize(sizeIntent As MASSize) As MASControlBase` |
| `WithCompactSize` | Function | `Public Function WithCompactSize() As MASControlBase` |
| `WithDefaultSize` | Function | `Public Function WithDefaultSize() As MASControlBase` |
| `WithFillWidthSize` | Function | `Public Function WithFillWidthSize() As MASControlBase` |
| `WithHugContentSize` | Function | `Public Function WithHugContentSize() As MASControlBase` |
| `WithLargeSize` | Function | `Public Function WithLargeSize() As MASControlBase` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASControlBase` |
| `ArchitectureValidationMessage` | Property | `Public ReadOnly Property ArchitectureValidationMessage As String` |
| `BoundsLogical` | Property | `Public Property BoundsLogical As SKRect` |
| `Enabled` | Property | `Public Property Enabled As Boolean` |
| `HasArchitectureContract` | Property | `Public ReadOnly Property HasArchitectureContract As Boolean` |
| `HasKeyboardFocus` | Property | `Public ReadOnly Property HasKeyboardFocus As Boolean` |
| `Name` | Property | `Public Property Name As String` |
| `SizeIntent` | Property | `Public ReadOnly Property SizeIntent As MASSize` |
| `Visible` | Property | `Public Property Visible As Boolean` |

**Minimal usage shape.**

```vb
' Use through documented product-control recipes or Application-owned factories when available.
' Review the category and stability note before making it a customer-facing contract.
```

### `MASDrawer`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/Drawer/MASDrawer.vb:20` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the stable Drawer control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Closed` | Event | `Public Event Closed As EventHandler` |
| `Opened` | Event | `Public Event Opened As EventHandler` |
| `Add` | Function | `Public Function Add(control As MASControlBase, relativeContentBounds As SKRect) As MASDrawer` |
| `Add` | Function | `Public Function Add(control As MASControlBase) As MASDrawer` |
| `Clear` | Function | `Public Function Clear() As MASDrawer` |
| `Close` | Function | `Public Function Close() As MASDrawer` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `Open` | Function | `Public Function Open() As MASDrawer` |
| `Remove` | Function | `Public Function Remove(control As MASControlBase) As MASDrawer` |
| `Toggle` | Function | `Public Function Toggle() As MASDrawer` |
| `WithDismissPolicy` | Function | `Public Function WithDismissPolicy(closeOnOutsidePointer As Boolean, closeOnEscape As Boolean, Optional swallowOutsidePointer As Boolean = True) As MASDrawer` |
| `WithSide` | Function | `Public Function WithSide(value As MASDrawerSide) As MASDrawer` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASDrawer` |
| `WithWidth` | Function | `Public Function WithWidth(value As Single) As MASDrawer` |
| `CloseOnEscape` | Property | `Public Property CloseOnEscape As Boolean` |
| `CloseOnOutsidePointer` | Property | `Public Property CloseOnOutsidePointer As Boolean` |
| `IsOpen` | Property | `Public ReadOnly Property IsOpen As Boolean` |
| `Panel` | Property | `Public ReadOnly Property Panel As MASSidePanel` |
| `Side` | Property | `Public Property Side As MASDrawerSide` |
| `SwallowOutsidePointer` | Property | `Public Property SwallowOutsidePointer As Boolean` |
| `Title` | Property | `Public Property Title As String` |
| `Width` | Property | `Public Property Width As Single` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASEmptyState`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/EmptyState/MASEmptyState.vb:25` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Empty State control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional description As String = Nothing) As MASEmptyState` |
| `WithDescription` | Function | `Public Function WithDescription(value As String) As MASEmptyState` |
| `WithIllustration` | Function | `Public Function WithIllustration(value As Boolean) As MASEmptyState` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASEmptyState` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASEmptyState` |
| `Description` | Property | `Public Property Description As String` |
| `ShowIllustration` | Property | `Public Property ShowIllustration As Boolean` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASExpander`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Container/Expander/MASExpander.Motion.vb:10`<br>`Component/Container/Expander/MASExpander.vb:24` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the stable Expander control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(title As String)` |
| `New` | Sub | `Public Sub New()` |
| `ExpandedChanged` | Event | `Public Event ExpandedChanged As EventHandler` |
| `Add` | Function | `Public Function Add(control As MASControlBase, relativeContentBounds As SKRect) As MASExpander` |
| `Add` | Function | `Public Function Add(control As MASControlBase) As MASExpander` |
| `Clear` | Function | `Public Function Clear() As MASExpander` |
| `Collapse` | Sub | `Public Sub Collapse()` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional expanded As Boolean = True) As MASExpander` |
| `Expand` | Sub | `Public Sub Expand()` |
| `Remove` | Function | `Public Function Remove(control As MASControlBase) As MASExpander` |
| `Toggle` | Sub | `Public Sub Toggle()` |
| `WithExpanded` | Function | `Public Function WithExpanded(value As Boolean) As MASExpander` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASExpander` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASExpander` |
| `IsExpanded` | Property | `Public Property IsExpanded As Boolean` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASFormValidationSummary`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/FormValidationSummary/MASFormValidationSummary.Motion.vb:14`<br>`Component/Feedback/FormValidationSummary/MASFormValidationSummary.vb:39` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Form Validation Summary control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `FormValidationSummaryChanged` | Event | `Public Event FormValidationSummaryChanged As EventHandler` |
| `AddMessage` | Function | `Public Function AddMessage(fieldLabel As String, message As String, Optional state As MASTextValidationState = MASTextValidationState.Error) As MASFormValidationSummary` |
| `AsNavigableSummary` | Function | `Public Function AsNavigableSummary() As MASFormValidationSummary` |
| `AsPassiveInformation` | Function | `Public Function AsPassiveInformation() As MASFormValidationSummary` |
| `ClearMessages` | Function | `Public Function ClearMessages() As MASFormValidationSummary` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASFormValidationSummary` |
| `WithInteractionMode` | Function | `Public Function WithInteractionMode(mode As MASFormValidationSummaryInteractionMode) As MASFormValidationSummary` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASFormValidationSummary` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASFormValidationSummary` |
| `ErrorCount` | Property | `Public ReadOnly Property ErrorCount As Integer` |
| `InteractionMode` | Property | `Public Property InteractionMode As MASFormValidationSummaryInteractionMode` |
| `MessageCount` | Property | `Public ReadOnly Property MessageCount As Integer` |
| `SummaryText` | Property | `Public ReadOnly Property SummaryText As String` |
| `Title` | Property | `Public Property Title As String` |
| `WarningCount` | Property | `Public ReadOnly Property WarningCount As Integer` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASGroupBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Container/GroupBox/MASGroupBox.Api.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.ContentHost.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.Helpers.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.Input.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.Lifetime.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.Measurement.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.Rendering.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.TitlePlate.vb:18`<br>`Component/Container/GroupBox/MASGroupBox.vb:62` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the stable Group Box control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(title As String)` |
| `New` | Sub | `Public Sub New()` |
| `AddChild` | Sub | `Public Sub AddChild(child As MASControlBase, relativeContentBounds As SKRect)` |
| `AddChild` | Sub | `Public Sub AddChild(child As MASControlBase)` |
| `Add` | Function | `Public Function Add(control As MASControlBase, relativeContentBounds As SKRect) As MASGroupBox` |
| `Add` | Function | `Public Function Add(control As MASControlBase) As MASGroupBox` |
| `ClearChildren` | Sub | `Public Sub ClearChildren()` |
| `Clear` | Function | `Public Function Clear() As MASGroupBox` |
| `Create` | Function | `Public Shared Function Create(title As String) As MASGroupBox` |
| `Create` | Function | `Public Shared Function Create() As MASGroupBox` |
| `Disable` | Function | `Public Function Disable() As MASGroupBox` |
| `Enable` | Function | `Public Function Enable() As MASGroupBox` |
| `GetContentBoundsLogical` | Function | `Public Function GetContentBoundsLogical() As SKRect` |
| `Hide` | Function | `Public Function Hide() As MASGroupBox` |
| `RemoveChild` | Sub | `Public Sub RemoveChild(child As MASControlBase)` |
| `Remove` | Function | `Public Function Remove(control As MASControlBase) As MASGroupBox` |
| `SetChildBoundsInContent` | Sub | `Public Sub SetChildBoundsInContent(child As MASControlBase, relativeContentBounds As SKRect)` |
| `Show` | Function | `Public Function Show() As MASGroupBox` |
| `WithBorderRecipe` | Function | `Public Function WithBorderRecipe(value As MASGroupBoxBorderRecipe) As MASGroupBox` |
| `WithBorderStrength` | Function | `Public Function WithBorderStrength(value As MASGroupBoxBorderStrength) As MASGroupBox` |
| `WithEnabled` | Function | `Public Function WithEnabled(value As Boolean) As MASGroupBox` |
| `WithPremiumBorder` | Function | `Public Function WithPremiumBorder(value As Boolean) As MASGroupBox` |
| `WithReserveHeaderWhenEmpty` | Function | `Public Function WithReserveHeaderWhenEmpty(value As Boolean) As MASGroupBox` |
| `WithSeparator` | Function | `Public Function WithSeparator(value As Boolean) As MASGroupBox` |
| `WithShadow` | Function | `Public Function WithShadow(value As Boolean) As MASGroupBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASGroupBox` |
| `WithSurfaceMaterial` | Function | `Public Function WithSurfaceMaterial(materialKey As String) As MASGroupBox` |
| `WithSurfaceSource` | Function | `Public Function WithSurfaceSource(value As MASGroupBoxSurfaceSource) As MASGroupBox` |
| `WithTitleNotch` | Function | `Public Function WithTitleNotch(value As Boolean) As MASGroupBox` |
| `WithTitlePlateStrength` | Function | `Public Function WithTitlePlateStrength(value As MASGroupBoxTitlePlateStrength) As MASGroupBox` |
| `WithTitle` | Function | `Public Function WithTitle(title As String) As MASGroupBox` |
| `WithVisible` | Function | `Public Function WithVisible(value As Boolean) As MASGroupBox` |
| `BorderRecipe` | Property | `Public Property BorderRecipe As MASGroupBoxBorderRecipe` |
| `BorderStrength` | Property | `Public Property BorderStrength As MASGroupBoxBorderStrength` |
| `DrawPremiumBorder` | Property | `Public Property DrawPremiumBorder As Boolean` |
| `DrawSeparator` | Property | `Public Property DrawSeparator As Boolean` |
| `DrawShadow` | Property | `Public Property DrawShadow As Boolean` |
| `ReserveHeaderWhenEmpty` | Property | `Public Property ReserveHeaderWhenEmpty As Boolean` |
| `SurfaceMaterial` | Property | `Public Property SurfaceMaterial As String` |
| `SurfaceSource` | Property | `Public Property SurfaceSource As MASGroupBoxSurfaceSource` |
| `TitleLift` | Property | `Public Property TitleLift As Single` |
| `TitleNotchEnabled` | Property | `Public Property TitleNotchEnabled As Boolean` |
| `TitlePlateStrength` | Property | `Public Property TitlePlateStrength As MASGroupBoxTitlePlateStrength` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASLabel`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Label/MASLabel.Measurement.vb:17`<br>`Component/Feedback/Label/MASLabel.Rendering.vb:18`<br>`Component/Feedback/Label/MASLabel.TextPolicy.vb:17`<br>`Component/Feedback/Label/MASLabel.vb:54` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** A stable text display control with Nexamas typography roles.

**When to use it.** Use it for short labels, helper text, captions, and headings that belong to the stable beginner control surface.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `ClearTextColor` | Sub | `Public Sub ClearTextColor()` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASLabel` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASLabel` |
| `WithText` | Function | `Public Function WithText(value As String) As MASLabel` |
| `FontSize` | Property | `Public Property FontSize As Single` |
| `FontWeight` | Property | `Public Property FontWeight As Integer` |
| `HasTextColor` | Property | `Public ReadOnly Property HasTextColor As Boolean` |
| `HorizontalAlignment` | Property | `Public Property HorizontalAlignment As MASHorizontalAlignment` |
| `LabelVariant` | Property | `Public Property LabelVariant As MASLabelVariant` |
| `LineHeightMultiplier` | Property | `Public Property LineHeightMultiplier As Single` |
| `MaxLines` | Property | `Public Property MaxLines As Integer` |
| `MultiLine` | Property | `Public Property MultiLine As Boolean` |
| `TextColor` | Property | `Public Property TextColor As SKColor` |
| `TextRole` | Property | `Public Property TextRole As MASLabelTextRole` |
| `TextStyle` | Property | `Public Property TextStyle As MASTypography.MASTextStyle` |
| `Text` | Property | `Public Property Text As String` |
| `VerticalAlignment` | Property | `Public Property VerticalAlignment As MASVerticalAlignment` |
| `WordWrap` | Property | `Public Property WordWrap As Boolean` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASLoadingSkeleton`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/LoadingSkeleton/MASLoadingSkeleton.vb:22` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Loading Skeleton control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create(Optional rowCount As Integer = 4) As MASLoadingSkeleton` |
| `WithAvatarText` | Function | `Public Function WithAvatarText(Optional lineCount As Integer = 3) As MASLoadingSkeleton` |
| `WithBlock` | Function | `Public Function WithBlock(Optional blockCount As Integer = 1) As MASLoadingSkeleton` |
| `WithCard` | Function | `Public Function WithCard(Optional lineCount As Integer = 3) As MASLoadingSkeleton` |
| `WithRows` | Function | `Public Function WithRows(Optional rowCount As Integer = 4) As MASLoadingSkeleton` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASLoadingSkeleton` |
| `AvatarVisible` | Property | `Public Property AvatarVisible As Boolean` |
| `LineCount` | Property | `Public Property LineCount As Integer` |
| `RowCount` | Property | `Public Property RowCount As Integer` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASNotificationPanel`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/NotificationPanel/MASNotificationPanel.Events.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.Interaction.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.ItemModel.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.Layout.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.Lifetime.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.Motion.vb:12`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.Rendering.Colors.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.Rendering.Rows.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.Rendering.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.ViewState.vb:19`<br>`Component/Feedback/NotificationPanel/MASNotificationPanel.vb:26` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Notification Panel control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `NotificationsChanged` | Event | `Public Event NotificationsChanged As EventHandler` |
| `AddNotification` | Function | `Public Function AddNotification(title As String, message As String, Optional tone As MASToastTone = MASToastTone.Info, Optional timestampText As String = Nothing, Optional actionText As String = Nothing, Optional isUnread As Boolean = True) As Integer` |
| `ClearNotifications` | Function | `Public Function ClearNotifications() As MASNotificationPanel` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASNotificationPanel` |
| `GetNotificationActionText` | Function | `Public Function GetNotificationActionText(index As Integer) As String` |
| `GetNotificationIsUnread` | Function | `Public Function GetNotificationIsUnread(index As Integer) As Boolean` |
| `GetNotificationMessage` | Function | `Public Function GetNotificationMessage(index As Integer) As String` |
| `GetNotificationTimestampText` | Function | `Public Function GetNotificationTimestampText(index As Integer) As String` |
| `GetNotificationTitle` | Function | `Public Function GetNotificationTitle(index As Integer) As String` |
| `GetNotificationTone` | Function | `Public Function GetNotificationTone(index As Integer) As MASToastTone` |
| `MarkAllRead` | Function | `Public Function MarkAllRead() As MASNotificationPanel` |
| `MarkRead` | Function | `Public Function MarkRead(index As Integer) As MASNotificationPanel` |
| `RemoveNotification` | Function | `Public Function RemoveNotification(index As Integer) As MASNotificationPanel` |
| `SetNotificationRead` | Function | `Public Function SetNotificationRead(index As Integer, read As Boolean) As MASNotificationPanel` |
| `WithEmptyText` | Function | `Public Function WithEmptyText(title As String, message As String) As MASNotificationPanel` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASNotificationPanel` |
| `WithTimestamps` | Function | `Public Function WithTimestamps(Optional value As Boolean = True) As MASNotificationPanel` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASNotificationPanel` |
| `EmptyMessage` | Property | `Public Property EmptyMessage As String` |
| `EmptyTitle` | Property | `Public Property EmptyTitle As String` |
| `NotificationCount` | Property | `Public ReadOnly Property NotificationCount As Integer` |
| `ShowTimestamps` | Property | `Public Property ShowTimestamps As Boolean` |
| `Title` | Property | `Public Property Title As String` |
| `UnreadCount` | Property | `Public ReadOnly Property UnreadCount As Integer` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASOperationProgressBox`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/ProgressBar/MASOperationProgressBox.Api.vb:19`<br>`Component/Feedback/ProgressBar/MASOperationProgressBox.ChildConstruction.vb:19`<br>`Component/Feedback/ProgressBar/MASOperationProgressBox.Helpers.vb:19`<br>`Component/Feedback/ProgressBar/MASOperationProgressBox.Layout.vb:19`<br>`Component/Feedback/ProgressBar/MASOperationProgressBox.Measurement.vb:19`<br>`Component/Feedback/ProgressBar/MASOperationProgressBox.Rendering.vb:19`<br>`Component/Feedback/ProgressBar/MASOperationProgressBox.vb:25` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Operation Progress Box control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(titleText As String, statusText As String)` |
| `New` | Sub | `Public Sub New(titleText As String)` |
| `New` | Sub | `Public Sub New()` |
| `ValueChanged` | Event | `Public Event ValueChanged As EventHandler` |
| `Complete` | Sub | `Public Sub Complete()` |
| `Create` | Function | `Public Shared Function Create(Optional titleText As String = Nothing, Optional statusText As String = Nothing) As MASOperationProgressBox` |
| `Danger` | Function | `Public Function Danger() As MASOperationProgressBox` |
| `Increment` | Sub | `Public Sub Increment(Optional stepValue As Double = 1.0)` |
| `Normal` | Function | `Public Function Normal() As MASOperationProgressBox` |
| `Reset` | Sub | `Public Sub Reset()` |
| `SetPercent` | Sub | `Public Sub SetPercent(percent As Double)` |
| `SetRange` | Sub | `Public Sub SetRange(min As Double, max As Double)` |
| `Success` | Function | `Public Function Success() As MASOperationProgressBox` |
| `Warning` | Function | `Public Function Warning() As MASOperationProgressBox` |
| `WithContainerStrengths` | Function | `Public Function WithContainerStrengths(border As MASSurfaceStrength, surface As MASSurfaceStrength) As MASOperationProgressBox` |
| `WithContainerSurfaceMaterial` | Function | `Public Function WithContainerSurfaceMaterial(materialKey As String) As MASOperationProgressBox` |
| `WithPercent` | Function | `Public Function WithPercent(percent As Double) As MASOperationProgressBox` |
| `WithRange` | Function | `Public Function WithRange(min As Double, max As Double) As MASOperationProgressBox` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASOperationProgressBox` |
| `WithState` | Function | `Public Function WithState(state As MASProgressBarState) As MASOperationProgressBox` |
| `WithStatus` | Function | `Public Function WithStatus(text As String) As MASOperationProgressBox` |
| `WithTitle` | Function | `Public Function WithTitle(text As String) As MASOperationProgressBox` |
| `WithValue` | Function | `Public Function WithValue(value As Double) As MASOperationProgressBox` |
| `ContainerBorderStrength` | Property | `Public Property ContainerBorderStrength As MASSurfaceStrength` |
| `ContainerSurfaceMaterialKey` | Property | `Public Property ContainerSurfaceMaterialKey As String` |
| `ContainerSurfaceStrength` | Property | `Public Property ContainerSurfaceStrength As MASSurfaceStrength` |
| `Maximum` | Property | `Public Property Maximum As Double` |
| `Minimum` | Property | `Public Property Minimum As Double` |
| `ProgressFraction` | Property | `Public ReadOnly Property ProgressFraction As Single` |
| `RecommendedSize` | Property | `Public ReadOnly Property RecommendedSize As SKSize` |
| `StatusText` | Property | `Public Property StatusText As String` |
| `TitleText` | Property | `Public Property TitleText As String` |
| `Value` | Property | `Public Property Value As Double` |
| `VisualState` | Property | `Public Property VisualState As MASProgressBarState` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASPopover`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Callout/MASPopover.vb:20` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Popover control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Closed` | Event | `Public Event Closed As EventHandler` |
| `Opened` | Event | `Public Event Opened As EventHandler` |
| `Close` | Function | `Public Function Close() As MASPopover` |
| `Dispose` | Sub | `Public Sub Dispose()` |
| `Open` | Function | `Public Function Open(anchorBoundsLogical As SKRect) As MASPopover` |
| `Open` | Function | `Public Function Open(x As Single, y As Single, width As Single, height As Single) As MASPopover` |
| `Toggle` | Function | `Public Function Toggle(anchorBoundsLogical As SKRect) As MASPopover` |
| `WithDismissPolicy` | Function | `Public Function WithDismissPolicy(closeOnOutsidePointer As Boolean, Optional closeOnEscape As Boolean = True, Optional swallowOutsidePointer As Boolean = True) As MASPopover` |
| `WithPlacement` | Function | `Public Function WithPlacement(value As MASCalloutPlacement) As MASPopover` |
| `WithText` | Function | `Public Function WithText(value As String) As MASPopover` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASPopover` |
| `CloseOnEscape` | Property | `Public Property CloseOnEscape As Boolean` |
| `CloseOnOutsidePointer` | Property | `Public Property CloseOnOutsidePointer As Boolean` |
| `IsOpen` | Property | `Public ReadOnly Property IsOpen As Boolean` |
| `Placement` | Property | `Public Property Placement As MASCalloutPlacement` |
| `SwallowOutsidePointer` | Property | `Public Property SwallowOutsidePointer As Boolean` |
| `Text` | Property | `Public Property Text As String` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASProgressBar`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/ProgressBar/MASProgressBar.Api.vb:17`<br>`Component/Feedback/ProgressBar/MASProgressBar.Helpers.vb:17`<br>`Component/Feedback/ProgressBar/MASProgressBar.LabelLayout.vb:17`<br>`Component/Feedback/ProgressBar/MASProgressBar.Measurement.vb:17`<br>`Component/Feedback/ProgressBar/MASProgressBar.Motion.vb:9`<br>`Component/Feedback/ProgressBar/MASProgressBar.Rendering.vb:17`<br>`Component/Feedback/ProgressBar/MASProgressBar.State.vb:17`<br>`Component/Feedback/ProgressBar/MASProgressBar.vb:59` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** A stable progress indicator with frame, label, and state options.

**When to use it.** Use it for determinate or stateful task progress inside feedback or operation UI.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `ValueChanged` | Event | `Public Event ValueChanged As EventHandler` |
| `CompleteProgress` | Function | `Public Function CompleteProgress() As MASProgressBar` |
| `Complete` | Sub | `Public Sub Complete()` |
| `Create` | Function | `Public Shared Function Create() As MASProgressBar` |
| `Danger` | Function | `Public Function Danger() As MASProgressBar` |
| `IncrementBy` | Function | `Public Function IncrementBy(Optional stepValue As Double = 1.0) As MASProgressBar` |
| `Increment` | Sub | `Public Sub Increment(Optional stepValue As Double = 1.0)` |
| `Normal` | Function | `Public Function Normal() As MASProgressBar` |
| `ResetProgress` | Function | `Public Function ResetProgress() As MASProgressBar` |
| `Reset` | Sub | `Public Sub Reset()` |
| `SetPercent` | Sub | `Public Sub SetPercent(percent As Double)` |
| `SetRange` | Sub | `Public Sub SetRange(min As Double, max As Double)` |
| `SetState` | Sub | `Public Sub SetState(state As MASProgressBarState)` |
| `Success` | Function | `Public Function Success() As MASProgressBar` |
| `Warning` | Function | `Public Function Warning() As MASProgressBar` |
| `WithAutoArrangeLabelAlignment` | Function | `Public Function WithAutoArrangeLabelAlignment(value As Boolean) As MASProgressBar` |
| `WithContainedField` | Function | `Public Function WithContainedField() As MASProgressBar` |
| `WithContainerStrengths` | Function | `Public Function WithContainerStrengths(border As MASSurfaceStrength, surface As MASSurfaceStrength) As MASProgressBar` |
| `WithContainerSurfaceMaterial` | Function | `Public Function WithContainerSurfaceMaterial(materialKey As String) As MASProgressBar` |
| `WithFrameMode` | Function | `Public Function WithFrameMode(frameMode As MASProgressBarFrameMode) As MASProgressBar` |
| `WithLabelPlacement` | Function | `Public Function WithLabelPlacement(placement As MASProgressBarLabelPlacement) As MASProgressBar` |
| `WithLabel` | Function | `Public Function WithLabel(label As MASLabel, Optional placement As MASProgressBarLabelPlacement = MASProgressBarLabelPlacement.Top) As MASProgressBar` |
| `WithPercent` | Function | `Public Function WithPercent(percent As Double) As MASProgressBar` |
| `WithRange` | Function | `Public Function WithRange(min As Double, max As Double) As MASProgressBar` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASProgressBar` |
| `WithState` | Function | `Public Function WithState(state As MASProgressBarState) As MASProgressBar` |
| `WithValue` | Function | `Public Function WithValue(value As Double) As MASProgressBar` |
| `WithoutFrame` | Function | `Public Function WithoutFrame() As MASProgressBar` |
| `WithoutLabel` | Function | `Public Function WithoutLabel() As MASProgressBar` |
| `AutoArrangeLabelAlignment` | Property | `Public Property AutoArrangeLabelAlignment As Boolean` |
| `ContainerBorderStrength` | Property | `Public Property ContainerBorderStrength As MASSurfaceStrength` |
| `ContainerSurfaceMaterialKey` | Property | `Public Property ContainerSurfaceMaterialKey As String` |
| `ContainerSurfaceStrength` | Property | `Public Property ContainerSurfaceStrength As MASSurfaceStrength` |
| `FrameMode` | Property | `Public Property FrameMode As MASProgressBarFrameMode` |
| `LabelPlacement` | Property | `Public Property LabelPlacement As MASProgressBarLabelPlacement` |
| `Label` | Property | `Public Property Label As MASLabel` |
| `Maximum` | Property | `Public Property Maximum As Double` |
| `Minimum` | Property | `Public Property Minimum As Double` |
| `ProgressFraction` | Property | `Public ReadOnly Property ProgressFraction As Single` |
| `Value` | Property | `Public Property Value As Double` |
| `VisualState` | Property | `Public Property VisualState As MASProgressBarState` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASSegmentedControl`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Selectors/SegmentedControl/MASSegmentedControl.vb:21` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** A stable segmented-choice control.

**When to use it.** Use it when the user must choose one option from a small set of visible alternatives.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler(Of MASSegmentedControlSelectionChangedEventArgs)` |
| `Create` | Function | `Public Shared Function Create() As MASSegmentedControl` |
| `Disable` | Function | `Public Function Disable() As MASSegmentedControl` |
| `Enable` | Function | `Public Function Enable() As MASSegmentedControl` |
| `Hide` | Function | `Public Function Hide() As MASSegmentedControl` |
| `Show` | Function | `Public Function Show() As MASSegmentedControl` |
| `WithEnabled` | Function | `Public Function WithEnabled(value As Boolean) As MASSegmentedControl` |
| `WithSegments` | Function | `Public Function WithSegments(items As IEnumerable(Of MASSegmentEntry)) As MASSegmentedControl` |
| `WithSegments` | Function | `Public Function WithSegments(labels As String()) As MASSegmentedControl` |
| `WithSelectedId` | Function | `Public Function WithSelectedId(id As String) As MASSegmentedControl` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(index As Integer) As MASSegmentedControl` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASSegmentedControl` |
| `WithVisible` | Function | `Public Function WithVisible(value As Boolean) As MASSegmentedControl` |
| `Segments` | Property | `Public ReadOnly Property Segments As IReadOnlyList(Of MASSegmentEntry)` |
| `SelectedId` | Property | `Public ReadOnly Property SelectedId As String` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedSegment` | Property | `Public ReadOnly Property SelectedSegment As MASSegmentEntry` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASSegmentedControlSelectionChangedEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Selectors/SegmentedControl/MASSegmentedControlSelectionChangedEventArgs.vb:12` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Carries typed event data for Segmented Control Selection Changed Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `NewIndex` | Property | `Public ReadOnly Property NewIndex As Integer` |
| `OldIndex` | Property | `Public ReadOnly Property OldIndex As Integer` |
| `SelectedSegment` | Property | `Public ReadOnly Property SelectedSegment As MASSegmentEntry` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASSelectorItemControl`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Selectors/SelectorItem/MASSelectorItemControl.vb:22` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** A stable selectable item control used by selector-like surfaces.

**When to use it.** Use it in selection UIs where a visible item needs checked/active/disabled state.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectionChanged` | Event | `Public Event SelectionChanged As EventHandler` |
| `AddItem` | Function | `Public Function AddItem(item As MASSelectorItemEntry) As MASSelectorItemControl` |
| `AddItem` | Function | `Public Function AddItem(id As String, label As String, count As Integer, glyph As MASSelectorItemGlyphKind, accent As SKColor) As MASSelectorItemControl` |
| `ClearItems` | Function | `Public Function ClearItems() As MASSelectorItemControl` |
| `ClearSelection` | Function | `Public Function ClearSelection() As MASSelectorItemControl` |
| `Create` | Function | `Public Shared Function Create() As MASSelectorItemControl` |
| `Disable` | Function | `Public Function Disable() As MASSelectorItemControl` |
| `Enable` | Function | `Public Function Enable() As MASSelectorItemControl` |
| `Hide` | Function | `Public Function Hide() As MASSelectorItemControl` |
| `Show` | Function | `Public Function Show() As MASSelectorItemControl` |
| `WithEnabled` | Function | `Public Function WithEnabled(value As Boolean) As MASSelectorItemControl` |
| `WithItems` | Function | `Public Function WithItems(items As IEnumerable(Of MASSelectorItemEntry)) As MASSelectorItemControl` |
| `WithSelectedId` | Function | `Public Function WithSelectedId(id As String) As MASSelectorItemControl` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(index As Integer) As MASSelectorItemControl` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASSelectorItemControl` |
| `WithSurfaceVisible` | Function | `Public Function WithSurfaceVisible(value As Boolean) As MASSelectorItemControl` |
| `WithVisible` | Function | `Public Function WithVisible(value As Boolean) As MASSelectorItemControl` |
| `Items` | Property | `Public ReadOnly Property Items As IReadOnlyList(Of MASSelectorItemEntry)` |
| `SelectedId` | Property | `Public ReadOnly Property SelectedId As String` |
| `SelectedIndex` | Property | `Public ReadOnly Property SelectedIndex As Integer` |
| `SelectedItem` | Property | `Public ReadOnly Property SelectedItem As MASSelectorItemEntry` |
| `SurfaceVisible` | Property | `Public ReadOnly Property SurfaceVisible As Boolean` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASSidePanel`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/Drawer/MASSidePanel.Motion.vb:12`<br>`Component/Navigation/Drawer/MASSidePanel.vb:24` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Provides the stable Side Panel control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(title As String)` |
| `New` | Sub | `Public Sub New()` |
| `CloseRequested` | Event | `Public Event CloseRequested As EventHandler` |
| `Add` | Function | `Public Function Add(control As MASControlBase, relativeContentBounds As SKRect) As MASSidePanel` |
| `Add` | Function | `Public Function Add(control As MASControlBase) As MASSidePanel` |
| `Clear` | Function | `Public Function Clear() As MASSidePanel` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing) As MASSidePanel` |
| `Remove` | Function | `Public Function Remove(control As MASControlBase) As MASSidePanel` |
| `WithCloseButton` | Function | `Public Function WithCloseButton(value As Boolean) As MASSidePanel` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASSidePanel` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASSidePanel` |
| `ShowCloseButton` | Property | `Public Property ShowCloseButton As Boolean` |
| `Title` | Property | `Public Property Title As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASStatusBanner`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/StatusBanner/MASStatusBanner.Governance.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Helpers.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Layout.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Lifetime.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Motion.vb:10`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Rendering.Content.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Rendering.Geometry.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Rendering.Surface.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.Rendering.vb:20`<br>`Component/Feedback/StatusBanner/MASStatusBanner.vb:25` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** A stable banner for inline success, warning, error, or informational status.

**When to use it.** Use it for page-level feedback that should remain visible until the state changes.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create(Optional title As String = Nothing, Optional message As String = Nothing, Optional tone As MASToastTone = MASToastTone.Info) As MASStatusBanner` |
| `WithIcon` | Function | `Public Function WithIcon(value As Boolean) As MASStatusBanner` |
| `WithMessage` | Function | `Public Function WithMessage(value As String) As MASStatusBanner` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASStatusBanner` |
| `WithTitle` | Function | `Public Function WithTitle(value As String) As MASStatusBanner` |
| `WithTone` | Function | `Public Function WithTone(value As MASToastTone) As MASStatusBanner` |
| `Message` | Property | `Public Property Message As String` |
| `ShowIcon` | Property | `Public Property ShowIcon As Boolean` |
| `Title` | Property | `Public Property Title As String` |
| `Tone` | Property | `Public Property Tone As MASToastTone` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASStepper`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/Stepper/MASStepper.Motion.vb:12`<br>`Component/Navigation/Stepper/MASStepper.vb:24` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the stable Stepper control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `CurrentStepChanged` | Event | `Public Event CurrentStepChanged As EventHandler` |
| `AddStep` | Function | `Public Function AddStep(title As String, Optional description As String = Nothing) As Integer` |
| `ClearSteps` | Function | `Public Function ClearSteps() As MASStepper` |
| `Create` | Function | `Public Shared Function Create(Optional orientation As MASStepperOrientation = MASStepperOrientation.Horizontal) As MASStepper` |
| `GetStepState` | Function | `Public Function GetStepState(index As Integer) As MASStepperStepState` |
| `GetStepTitle` | Function | `Public Function GetStepTitle(index As Integer) As String` |
| `MoveNext` | Sub | `Public Sub MoveNext()` |
| `MovePrevious` | Sub | `Public Sub MovePrevious()` |
| `RemoveStep` | Function | `Public Function RemoveStep(index As Integer) As MASStepper` |
| `SetCurrentStep` | Sub | `Public Sub SetCurrentStep(index As Integer)` |
| `SetStepState` | Function | `Public Function SetStepState(index As Integer, state As MASStepperStepState) As MASStepper` |
| `SetStepText` | Function | `Public Function SetStepText(index As Integer, title As String, Optional description As String = Nothing) As MASStepper` |
| `WithCurrentStep` | Function | `Public Function WithCurrentStep(index As Integer) As MASStepper` |
| `WithOrientation` | Function | `Public Function WithOrientation(value As MASStepperOrientation) As MASStepper` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASStepper` |
| `CurrentIndex` | Property | `Public Property CurrentIndex As Integer` |
| `Orientation` | Property | `Public Property Orientation As MASStepperOrientation` |
| `StepCount` | Property | `Public ReadOnly Property StepCount As Integer` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASTabControl`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Selectors/Tabs/MASTabControl.Interaction.vb:11`<br>`Component/Selectors/Tabs/MASTabControl.Layout.vb:11`<br>`Component/Selectors/Tabs/MASTabControl.Lifetime.vb:9`<br>`Component/Selectors/Tabs/MASTabControl.Motion.vb:9`<br>`Component/Selectors/Tabs/MASTabControl.Rendering.vb:9`<br>`Component/Selectors/Tabs/MASTabControl.Scrolling.vb:11`<br>`Component/Selectors/Tabs/MASTabControl.Selection.vb:6`<br>`Component/Selectors/Tabs/MASTabControl.SizeFluent.vb:6`<br>`Component/Selectors/Tabs/MASTabControl.Tooltip.vb:11`<br>`Component/Selectors/Tabs/MASTabControl.vb:15` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** A stable tabbed navigation control.

**When to use it.** Use it to split related content into named pages while keeping the user in the same workflow.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `SelectedIndexChanged` | Event | `Public Event SelectedIndexChanged As EventHandler` |
| `SelectedItemChanged` | Event | `Public Event SelectedItemChanged As EventHandler` |
| `AddTab` | Function | `Public Function AddTab(text As String, Optional key As String = "", Optional enabled As Boolean = True) As MASTabItem` |
| `ClearTabs` | Sub | `Public Sub ClearTabs()` |
| `Create` | Function | `Public Shared Function Create() As MASTabControl` |
| `TryGetTooltipTextAt` | Function | `Public Function TryGetTooltipTextAt(clientX As Single, clientY As Single, ByRef text As String) As Boolean` |
| `WithSelectedIndex` | Function | `Public Function WithSelectedIndex(value As Integer) As MASTabControl` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTabControl` |
| `WithTab` | Function | `Public Function WithTab(text As String, Optional key As String = "", Optional enabled As Boolean = True) As MASTabControl` |
| `Items` | Property | `Public ReadOnly Property Items As IReadOnlyList(Of MASTabItem)` |
| `PressedIndex` | Property | `Public ReadOnly Property PressedIndex As Integer` |
| `SelectedIndex` | Property | `Public Property SelectedIndex As Integer` |
| `SelectedItem` | Property | `Public ReadOnly Property SelectedItem As MASTabItem` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASTabItem`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Selectors/Tabs/MASTabItem.vb:6` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Provides a typed model/DTO used by the Tab Item control or component.

**When to use it.** Use it with the owning control/component rather than inventing an unrelated shape.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String, Optional key As String = "", Optional enabled As Boolean = True)` |
| `Create` | Function | `Public Shared Function Create(text As String, Optional key As String = "", Optional enabled As Boolean = True) As MASTabItem` |
| `DisabledItem` | Function | `Public Function DisabledItem() As MASTabItem` |
| `EnabledItem` | Function | `Public Function EnabledItem(Optional value As Boolean = True) As MASTabItem` |
| `WithKey` | Function | `Public Function WithKey(key As String) As MASTabItem` |
| `WithText` | Function | `Public Function WithText(text As String) As MASTabItem` |
| `Enabled` | Property | `Public Property Enabled As Boolean` |
| `Key` | Property | `Public Property Key As String` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASTitle`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Reusable/TitleSeparator/MASTitle.vb:17` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** A stable title/header text control for page and section headings.

**When to use it.** Use it when the text is semantically a title rather than a small field label.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New(text As String)` |
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create(text As String) As MASTitle` |
| `WithDivider` | Function | `Public Function WithDivider(value As Boolean) As MASTitle` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASTitle` |
| `WithText` | Function | `Public Function WithText(text As String) As MASTitle` |
| `DrawDivider` | Property | `Public Property DrawDivider As Boolean` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASToastEventArgs`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Toast/MASToastTypes.vb:174` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Carries typed event data for Toast Event Args notifications.

**When to use it.** Use it from event handlers; do not construct it unless the owning API documents that route.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ToastId` | Property | `Public ReadOnly Property ToastId As Integer` |

**Minimal usage shape.**

```vb
' Handle this type from the owning control/component event.
```

### `MASToastOptions`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Toast/MASToastTypes.vb:35` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Options for stable toast notifications.

**When to use it.** Use it to configure placement, tone, timeout, and behavior for window-owned toast feedback.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create() As MASToastOptions` |
| `Danger` | Function | `Public Shared Function Danger(message As String, Optional title As String = "") As MASToastOptions` |
| `Info` | Function | `Public Shared Function Info(message As String, Optional title As String = "") As MASToastOptions` |
| `NotDismissible` | Function | `Public Function NotDismissible() As MASToastOptions` |
| `Persistent` | Function | `Public Function Persistent() As MASToastOptions` |
| `Success` | Function | `Public Shared Function Success(message As String, Optional title As String = "") As MASToastOptions` |
| `Warning` | Function | `Public Shared Function Warning(message As String, Optional title As String = "") As MASToastOptions` |
| `WithAction` | Function | `Public Function WithAction(text As String, callback As Action) As MASToastOptions` |
| `WithDismissible` | Function | `Public Function WithDismissible(Optional value As Boolean = True) As MASToastOptions` |
| `WithDuration` | Function | `Public Function WithDuration(milliseconds As Integer) As MASToastOptions` |
| `WithLifetimeBar` | Function | `Public Function WithLifetimeBar(Optional visible As Boolean = True) As MASToastOptions` |
| `WithMessage` | Function | `Public Function WithMessage(text As String) As MASToastOptions` |
| `WithSurfaceMaterial` | Function | `Public Function WithSurfaceMaterial(materialKey As String) As MASToastOptions` |
| `WithTitle` | Function | `Public Function WithTitle(text As String) As MASToastOptions` |
| `WithTone` | Function | `Public Function WithTone(value As MASToastTone) As MASToastOptions` |
| `WithUndo` | Function | `Public Function WithUndo(callback As Action) As MASToastOptions` |
| `WithoutLifetimeBar` | Function | `Public Function WithoutLifetimeBar() As MASToastOptions` |
| `WithoutUndo` | Function | `Public Function WithoutUndo() As MASToastOptions` |
| `ActionCallback` | Property | `Public Property ActionCallback As Action` |
| `ActionText` | Property | `Public Property ActionText As String` |
| `Dismissible` | Property | `Public Property Dismissible As Boolean` |
| `DurationMs` | Property | `Public Property DurationMs As Integer` |
| `Message` | Property | `Public Property Message As String` |
| `ShowLifetimeBar` | Property | `Public Property ShowLifetimeBar As Boolean` |
| `SurfaceMaterial` | Property | `Public Property SurfaceMaterial As String` |
| `Title` | Property | `Public Property Title As String` |
| `Tone` | Property | `Public Property Tone As MASToastTone` |
| `UndoCallback` | Property | `Public Property UndoCallback As Action` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASValidationMessage`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/ValidationMessage/MASValidationMessage.vb:25` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Provides the stable Validation Message control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `Create` | Function | `Public Shared Function Create(Optional text As String = Nothing) As MASValidationMessage` |
| `WithIcon` | Function | `Public Function WithIcon(value As Boolean) As MASValidationMessage` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASValidationMessage` |
| `WithState` | Function | `Public Function WithState(value As MASTextValidationState) As MASValidationMessage` |
| `WithText` | Function | `Public Function WithText(value As String) As MASValidationMessage` |
| `ShowIcon` | Property | `Public Property ShowIcon As Boolean` |
| `State` | Property | `Public Property State As MASTextValidationState` |
| `Text` | Property | `Public Property Text As String` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASWinControlBase`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `MASSystem/Core/Framework/Controls/WinForms/MASWinControlBase.vb:24` |
| Related recipes | [product-controls](../../recipes/product-controls.md) |

**What it does.** Provides the stable Win Control Base control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `SetSize` | Function | `Public Function SetSize(sizeIntent As MASSize) As MASWinControlBase` |
| `WithCompactSize` | Function | `Public Function WithCompactSize() As MASWinControlBase` |
| `WithDefaultSize` | Function | `Public Function WithDefaultSize() As MASWinControlBase` |
| `WithFillWidthSize` | Function | `Public Function WithFillWidthSize() As MASWinControlBase` |
| `WithHugContentSize` | Function | `Public Function WithHugContentSize() As MASWinControlBase` |
| `WithLargeSize` | Function | `Public Function WithLargeSize() As MASWinControlBase` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASWinControlBase` |
| `AutoTheme` | Property | `Public Property AutoTheme As Boolean` |
| `ResolvedTheme` | Property | `Public ReadOnly Property ResolvedTheme As IMASAppTheme` |
| `SizeIntent` | Property | `Public ReadOnly Property SizeIntent As MASSize` |
| `ThemeOverride` | Property | `Public Property ThemeOverride As IMASAppTheme` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASWizard`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Class` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/Stepper/MASWizard.vb:23` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Provides the stable Wizard control surface in Nexamas UI.

**When to use it.** Use it through the Application/window-owned control route when possible; direct use is acceptable only where the documentation or recipes show it.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `New` | Sub | `Public Sub New()` |
| `CurrentStepChanged` | Event | `Public Event CurrentStepChanged As EventHandler` |
| `AddStep` | Function | `Public Function AddStep(title As String, Optional description As String = Nothing, Optional content As MASControlBase = Nothing) As MASWizard` |
| `ClearSteps` | Function | `Public Function ClearSteps() As MASWizard` |
| `Create` | Function | `Public Shared Function Create(Optional orientation As MASStepperOrientation = MASStepperOrientation.Horizontal) As MASWizard` |
| `GetStepContent` | Function | `Public Function GetStepContent(index As Integer) As MASControlBase` |
| `MoveNext` | Sub | `Public Sub MoveNext()` |
| `MovePrevious` | Sub | `Public Sub MovePrevious()` |
| `RemoveStep` | Function | `Public Function RemoveStep(index As Integer) As MASWizard` |
| `SetCurrentStep` | Sub | `Public Sub SetCurrentStep(index As Integer)` |
| `SetStepContent` | Function | `Public Function SetStepContent(index As Integer, content As MASControlBase) As MASWizard` |
| `WithCurrentStep` | Function | `Public Function WithCurrentStep(index As Integer) As MASWizard` |
| `WithOrientation` | Function | `Public Function WithOrientation(value As MASStepperOrientation) As MASWizard` |
| `WithSize` | Function | `Public Function WithSize(sizeIntent As MASSize) As MASWizard` |
| `CanMoveNext` | Property | `Public ReadOnly Property CanMoveNext As Boolean` |
| `CanMovePrevious` | Property | `Public ReadOnly Property CanMovePrevious As Boolean` |
| `CurrentIndex` | Property | `Public ReadOnly Property CurrentIndex As Integer` |
| `Orientation` | Property | `Public Property Orientation As MASStepperOrientation` |
| `StepCount` | Property | `Public ReadOnly Property StepCount As Integer` |

**Minimal usage shape.**

```vb
' Prefer the MASApplication / MASApplicationWindow control-factory route.
' See the related recipe group for a build-verified consumer path.
```

### `MASButtonIconPlacement`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Buttons/MASButton/Control/MASButton.vb:20` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Button Icon Placement API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Bottom` | Enum value | `Bottom = 3` |
| `Left` | Enum value | `Left = 0` |
| `Right` | Enum value | `Right = 1` |
| `Top` | Enum value | `Top = 2` |

**Minimal usage shape.**

```vb
' Pass MASButtonIconPlacement values only to APIs that explicitly accept this enum.
```

### `MASCalloutPlacement`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Callout/MASCalloutPlacement.vb:10` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines option values for the Callout Placement API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Auto` | Enum value | `Auto = 0` |
| `Bottom` | Enum value | `Bottom = 2` |
| `Left` | Enum value | `Left = 3` |
| `Right` | Enum value | `Right = 4` |
| `Top` | Enum value | `Top = 1` |

**Minimal usage shape.**

```vb
' Pass MASCalloutPlacement values only to APIs that explicitly accept this enum.
```

### `MASDrawerSide`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/Drawer/MASDrawerSide.vb:9` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Defines option values for the Drawer Side API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Left` | Enum value | `Left = 0` |
| `Right` | Enum value | `Right = 1` |

**Minimal usage shape.**

```vb
' Pass MASDrawerSide values only to APIs that explicitly accept this enum.
```

### `MASFormValidationSummaryInteractionMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/FormValidationSummary/MASFormValidationSummary.vb:27` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines option values for the Form Validation Summary Interaction Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Navigable` | Enum value | `Navigable = 1` |
| `Passive` | Enum value | `Passive = 0` |

**Minimal usage shape.**

```vb
' Pass MASFormValidationSummaryInteractionMode values only to APIs that explicitly accept this enum.
```

### `MASGroupBoxBorderRecipe`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Container/GroupBox/MASGroupBox.vb:29` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Defines option values for the Group Box Border Recipe API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `AcrylicSurface` | Enum value | `AcrylicSurface = 1` |
| `ListSurface` | Enum value | `ListSurface = 0` |

**Minimal usage shape.**

```vb
' Pass MASGroupBoxBorderRecipe values only to APIs that explicitly accept this enum.
```

### `MASGroupBoxBorderStrength`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Container/GroupBox/MASGroupBox.vb:37` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Defines option values for the Group Box Border Strength API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Level1` | Enum value | `Level1 = 1` |
| `Level2` | Enum value | `Level2 = 2` |
| `Level3` | Enum value | `Level3 = 3` |
| `Level4` | Enum value | `Level4 = 4` |
| `Level5` | Enum value | `Level5 = 5` |
| `Level6` | Enum value | `Level6 = 6` |

**Minimal usage shape.**

```vb
' Pass MASGroupBoxBorderStrength values only to APIs that explicitly accept this enum.
```

### `MASGroupBoxSurfaceSource`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Container/GroupBox/MASGroupBox.vb:20` |
| Related recipes | [surfaces](../../recipes/surfaces.md) |

**What it does.** Defines option values for the Group Box Surface Source API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Acrylic` | Enum value | `Acrylic = 0` |
| `Plain` | Enum value | `Plain = 1` |
| `TransparentFrame` | Enum value | `TransparentFrame = 2` |

**Minimal usage shape.**

```vb
' Pass MASGroupBoxSurfaceSource values only to APIs that explicitly accept this enum.
```

### `MASGroupBoxTitlePlateStrength`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Container/GroupBox/MASGroupBox.vb:49` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Group Box Title Plate Strength API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Premium` | Enum value | `Premium = 1` |
| `Soft` | Enum value | `Soft = 0` |
| `Strong` | Enum value | `Strong = 2` |

**Minimal usage shape.**

```vb
' Pass MASGroupBoxTitlePlateStrength values only to APIs that explicitly accept this enum.
```

### `MASHorizontalAlignment`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Label/MASLabel.vb:31` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Horizontal Alignment API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Center` | Enum value | `Center = 1` |
| `Left` | Enum value | `Left = 0` |
| `Right` | Enum value | `Right = 2` |

**Minimal usage shape.**

```vb
' Pass MASHorizontalAlignment values only to APIs that explicitly accept this enum.
```

### `MASLabelTextRole`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Label/MASLabel.vb:21` |
| Related recipes | [inputs](../../recipes/inputs.md) |

**What it does.** Defines option values for the Label Text Role API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Disabled` | Enum value | `Disabled = 3` |
| `Inverse` | Enum value | `Inverse = 4` |
| `Muted` | Enum value | `Muted = 2` |
| `OnBrandPrimaryStrong` | Enum value | `OnBrandPrimaryStrong = 6` |
| `OnBrandPrimary` | Enum value | `OnBrandPrimary = 5` |
| `Primary` | Enum value | `Primary = 0` |
| `Secondary` | Enum value | `Secondary = 1` |

**Minimal usage shape.**

```vb
' Pass MASLabelTextRole values only to APIs that explicitly accept this enum.
```

### `MASLabelVariant`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Label/MASLabel.vb:43` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Label Variant API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Body` | Enum value | `Body = 3` |
| `Button` | Enum value | `Button = 6` |
| `Caption` | Enum value | `Caption = 4` |
| `Heading` | Enum value | `Heading = 1` |
| `Micro` | Enum value | `Micro = 5` |
| `Subtitle` | Enum value | `Subtitle = 2` |
| `Title` | Enum value | `Title = 0` |
| `TopBarTitle` | Enum value | `TopBarTitle = 7` |

**Minimal usage shape.**

```vb
' Pass MASLabelVariant values only to APIs that explicitly accept this enum.
```

### `MASProgressBarFrameMode`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/ProgressBar/MASProgressBar.vb:50` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines option values for the Progress Bar Frame Mode API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `ContainedField` | Enum value | `ContainedField = 1` |
| `None` | Enum value | `None = 0` |

**Minimal usage shape.**

```vb
' Pass MASProgressBarFrameMode values only to APIs that explicitly accept this enum.
```

### `MASProgressBarLabelPlacement`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/ProgressBar/MASProgressBar.vb:23` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Progress Bar Label Placement API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Bottom` | Enum value | `Bottom = 2` |
| `InsideCenter` | Enum value | `InsideCenter = 5` |
| `Left` | Enum value | `Left = 3` |
| `None` | Enum value | `None = 0` |
| `Right` | Enum value | `Right = 4` |
| `Top` | Enum value | `Top = 1` |

**Minimal usage shape.**

```vb
' Pass MASProgressBarLabelPlacement values only to APIs that explicitly accept this enum.
```

### `MASStepperOrientation`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/Stepper/MASStepperOrientation.vb:9` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the Stepper Orientation API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

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

**Minimal usage shape.**

```vb
' Pass MASStepperOrientation values only to APIs that explicitly accept this enum.
```

### `MASStepperStepState`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Navigation/Stepper/MASStepperStepState.vb:9` |
| Related recipes | [navigation](../../recipes/navigation.md) |

**What it does.** Defines option values for the Stepper Step State API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Completed` | Enum value | `Completed = 2` |
| `Current` | Enum value | `Current = 1` |
| `Disabled` | Enum value | `Disabled = 3` |
| `Error` | Enum value | `Error = 4` |
| `Pending` | Enum value | `Pending = 0` |

**Minimal usage shape.**

```vb
' Pass MASStepperStepState values only to APIs that explicitly accept this enum.
```

### `MASToastPlacement`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Toast/MASToastTypes.vb:24` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines option values for the Toast Placement API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `BottomLeft` | Enum value | `BottomLeft = 1` |
| `BottomRight` | Enum value | `BottomRight = 0` |
| `TopLeft` | Enum value | `TopLeft = 3` |
| `TopRight` | Enum value | `TopRight = 2` |

**Minimal usage shape.**

```vb
' Pass MASToastPlacement values only to APIs that explicitly accept this enum.
```

### `MASToastTone`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Toast/MASToastTypes.vb:13` |
| Related recipes | [feedback](../../recipes/feedback.md) |

**What it does.** Defines option values for the Toast Tone API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Danger` | Enum value | `Danger = 4` |
| `Info` | Enum value | `Info = 2` |
| `Neutral` | Enum value | `Neutral = 0` |
| `Success` | Enum value | `Success = 1` |
| `Warning` | Enum value | `Warning = 3` |

**Minimal usage shape.**

```vb
' Pass MASToastTone values only to APIs that explicitly accept this enum.
```

### `MASVerticalAlignment`

| Field | Value |
|---|---|
| Namespace | `Nexamas.UI.Controls` |
| Kind | `Enum` |
| Category | `Stable` |
| V1 approval | `V1Stable` |
| Evidence | `Component/Feedback/Label/MASLabel.vb:37` |
| Related recipes | [buttons](../../recipes/buttons.md) |

**What it does.** Defines option values for the Vertical Alignment API surface.

**When to use it.** Use it only with the control/component member that explicitly accepts this enum.

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

| Member | Kind | Assembly-verified signature |
|---|---|---|
| `Bottom` | Enum value | `Bottom = 2` |
| `Center` | Enum value | `Center = 1` |
| `Top` | Enum value | `Top = 0` |

**Minimal usage shape.**

```vb
' Pass MASVerticalAlignment values only to APIs that explicitly accept this enum.
```
