# Layout / Size Public Surface Reference

This page is a source-derived reference for the public Layout/Size consumer surface found during the static documentation pass.

## Static source counts

| Source area | VB files on disk | Included in project | Missing from project | Broken project includes |
|---|---:|---:|---:|---:|
| `MASSystem/Layout/` | 157 | 157 | 0 | 0 |
| `MASSystem/Layout/SizeLayoutSystem/` | 65 | 65 | 0 | 0 |
| `MASSystem/Layout/Composition/` | 50 | 50 | 0 | 0 |

## Public layout/size-related types

| Type | Kind | Evidence |
|---|---|---|
| `MASApplicationActionGroupAlignment` | Enum | `MASSystem/Application/Facade/MASApplicationControlsActionGroupLayout.vb:15` |
| `MASApplicationActionGroupLayoutBuilder` | Class | `MASSystem/Application/Facade/MASApplicationControlsActionGroupLayout.vb:26` |
| `MASApplicationFilterBarAlignment` | Enum | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:27` |
| `MASApplicationFilterBarDirection` | Enum | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:17` |
| `MASApplicationFilterBarLayoutBuilder` | Class | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:38` |
| `MASApplicationFormRowLayoutBuilder` | Class | `MASSystem/Application/Facade/MASApplicationControlsFilterFormLayout.vb:440` |
| `MASApplicationGalleryAlignment` | Enum | `MASSystem/Application/Facade/MASApplicationControlsGalleryLayout.vb:28` |
| `MASApplicationGalleryLayoutBuilder` | Class | `MASSystem/Application/Facade/MASApplicationControlsGalleryLayout.vb:39` |
| `MASApplicationGalleryTileSize` | Enum | `MASSystem/Application/Facade/MASApplicationControlsGalleryLayout.vb:16` |
| `MASApplicationLayoutFlowBuilder` | Class | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:18` |
| `MASApplicationLayoutGridBuilder` | Class | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:19` |
| `MASApplicationLayoutPageBuilder` | Class | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:20` |
| `MASApplicationLayoutStackBuilder` | Class | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:18` |
| `MASApplicationPageLayoutKind` | Enum | `MASSystem/Application/Facade/MASApplicationLayoutPolicy.vb:15` |
| `MASApplicationSplitPaneLayoutBuilder` | Class | `MASSystem/Application/Facade/MASApplicationSplitPaneLayoutBuilder.vb:21` |
| `MASApplicationSurfaceBarSize` | Enum | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:32` |
| `MASApplicationSurfaceCommandBarPlacement` | Enum | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:44` |
| `MASApplicationSurfaceFooterPlacement` | Enum | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:56` |
| `MASApplicationSurfaceLayoutBuilder` | Class | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Backgrounds.vb:16` |
| `MASApplicationSurfaceRhythm` | Enum | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:68` |
| `MASApplicationSurfaceSideSize` | Enum | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutEnums.vb:21` |
| `MASApplicationWindowControls` | Class | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutOwnership.vb:16` |
| `MASControlDensity` | Enum | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb:19` |
| `MASLayoutInset` | Structure | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb:139` |
| `MASLayoutSpacing` | Enum | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASLayoutSpacingSystem.vb:14` |
| `MASSize` | Class | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb:245` |
| `MASSizeAdjustment` | Class | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb:200` |
| `MASSizeIntentKind` | Enum | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb:11` |
| `MASSizeProfile` | Class | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb:41` |
| `MASSizeProfileChangedEventArgs` | Class | `MASSystem/Layout/SizeLayoutSystem/Runtime/MASRuntimeSizeProfileService.vb:13` |
| `MASSizeProfileKind` | Enum | `MASSystem/Layout/SizeLayoutSystem/Sizing/MASSizeSystem.vb:30` |

## Public retained layout gateway methods

| Method | Visibility | Evidence |
|---|---|---|
| `LayoutPage` | Public | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutPage.vb:24` |
| `LayoutPage` | Public | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutPage.vb:29` |
| `LayoutPage` | Public | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutPage.vb:35` |
| `LayoutApplicationSurface` | Public | `MASSystem/Application/Facade/MASApplicationWindowControls.ApplicationSurface.vb:23` |
| `LayoutApplicationSurface` | Public | `MASSystem/Application/Facade/MASApplicationWindowControls.ApplicationSurface.vb:28` |
| `LayoutApplicationSurface` | Public | `MASSystem/Application/Facade/MASApplicationWindowControls.ApplicationSurface.vb:34` |
| `LayoutRegions` | Friend | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutRegions.vb:23` |
| `LayoutRegions` | Friend | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutRegions.vb:29` |
| `LayoutRegions` | Friend | `MASSystem/Application/Facade/MASApplicationWindowControls.LayoutRegions.vb:36` |
| `ApplicationPage` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:34` |
| `Spacing` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:55` |
| `Padding` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:71` |
| `Section` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:129` |
| `FullWidth` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:144` |
| `Add` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:167` |
| `Grid` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:176` |
| `Flow` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:182` |
| `StackVertical` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:188` |
| `StackHorizontal` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:194` |
| `ActionGroup` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:205` |
| `ActionGroup` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:214` |
| `FilterBar` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:225` |
| `FilterBar` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:234` |
| `FormRow` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:244` |
| `FormRow` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:253` |
| `Gallery` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:265` |
| `Gallery` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:274` |
| `SplitPane` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:286` |
| `SplitPane` | Public | `MASSystem/Application/Facade/MASApplicationLayoutPageBuilder.vb:296` |
| `CommandBar` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:17` |
| `Sidebar` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:22` |
| `Sidebar` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:27` |
| `Navigation` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:39` |
| `Navigation` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:43` |
| `LeftSide` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:48` |
| `LeftSide` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:52` |
| `SidebarFooter` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:57` |
| `Content` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:62` |
| `Workspace` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:72` |
| `MainContent` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:76` |
| `Inspector` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:80` |
| `Inspector` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:85` |
| `RightSide` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:92` |
| `RightSide` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:96` |
| `Footer` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Regions.vb:101` |
| `ShowCommandBackground` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:17` |
| `ShowRegionBackgrounds` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:29` |
| `WithCommandBackgroundSurfaceMaterial` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:34` |
| `WithRegionBackgroundSurfaceMaterial` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:39` |

## Application chrome sizing

Standard application chrome sizing is resolved through MASSize contracts:

| Contract | Role |
|---|---|
| `ResolveApplicationTopBarHeight(profile)` | Active-profile standard TopBar height. |
| `ResolveApplicationMenuBarHeight(profile)` | Active-profile standard MainMenuBar height. |
| `MASApplicationWindowShell.StandardContentTopLogical` | TopBar + optional MainMenuBar + MAS-owned chrome gap. |

`LayoutPage(...).ApplicationPage(...)` and `LayoutApplicationSurface(...).ReserveStandardTopBar(shell)` consume the shell's `StandardContentTopLogical`, so pages do not carry independent Y offsets when a standard MainMenuBar is attached.

| `ReserveStandardTopBar` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:50` |
| `ApplicationChrome` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:61` |
| `CommandBarPlacement` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:70` |
| `CommandBarFullApplicationSurfaceTop` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:79` |
| `CommandBarMainAreaTop` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:87` |
| `FooterPlacement` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:97` |
| `FooterFullApplicationSurfaceBottom` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:106` |
| `FooterMainAreaBottom` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Chrome.vb:114` |
| `Gap` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:29` |
| `Rhythm` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:39` |
| `CompactRhythm` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:64` |
| `ComfortableRhythm` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:68` |
| `SpaciousRhythm` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:72` |
| `CommandBodyGap` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:80` |
| `BodyFooterGap` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:95` |
| `ColumnGap` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:110` |
| `SidebarFooterGap` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:125` |
| `Padding` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:146` |
| `SidebarSize` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:160` |
| `InspectorSize` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:165` |
| `CommandBarSize` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:170` |
| `FooterSize` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:181` |
| `SidebarFooterSize` | Public | `MASSystem/Application/Facade/MASApplicationSurfaceLayoutBuilder.Spacing.vb:186` |
| `Gap` | Public | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:36` |
| `Spacing` | Public | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:46` |
| `Padding` | Public | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:56` |
| `EqualItemWidth` | Public | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:73` |
| `EqualItemSize` | Public | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:81` |
| `IntrinsicItemSize` | Public | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:89` |
| `Add` | Public | `MASSystem/Application/Facade/MASApplicationLayoutGridBuilder.vb:94` |
| `Gap` | Public | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:30` |
| `Spacing` | Public | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:35` |
| `Padding` | Public | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:45` |
| `EqualItemWidth` | Public | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:53` |
| `EqualItemSize` | Public | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:61` |
| `IntrinsicItemSize` | Public | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:69` |
| `Add` | Public | `MASSystem/Application/Facade/MASApplicationLayoutFlowBuilder.vb:74` |
| `Spacing` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:36` |
| `Padding` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:47` |
| `Stretch` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:52` |
| `HugContent` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:57` |
| `EqualItemWidth` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:65` |
| `EqualItemSize` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:73` |
| `IntrinsicItemSize` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:81` |
| `Add` | Public | `MASSystem/Application/Facade/MASApplicationLayoutStackBuilder.vb:86` |
| `Gap` | Public | `MASSystem/Application/Facade/MASApplicationSplitPaneLayoutBuilder.vb:34` |
| `Spacing` | Public | `MASSystem/Application/Facade/MASApplicationSplitPaneLayoutBuilder.vb:39` |
| `AddNarrative` | Public | `MASSystem/Application/Facade/MASApplicationSplitPaneLayoutBuilder.vb:48` |
| `AddSurface` | Public | `MASSystem/Application/Facade/MASApplicationSplitPaneLayoutBuilder.vb:61` |

## Size profile facades

| Facade | Public role | Evidence |
|---|---|---|
| `MASApplicationSizing` | Application-level runtime size profile gateway. | `MASSystem/Application/Facade/MASApplicationSizing.vb` |
| `MASApplicationWindowSizing` | Window-facing runtime size profile gateway plus `Refresh()`. | `MASSystem/Application/Facade/MASApplicationWindowSizing.vb` |
| `MASSizeProfileChangedEventArgs` | Public immutable change event payload. | `MASSystem/Layout/SizeLayoutSystem/Runtime/MASRuntimeSizeProfileService.vb` |

## Geometry facade

`MASApplicationWindowGeometry` exposes:

- `SurfaceSizePx`
- `Dpi`
- `SurfaceViewportPx(...)`
- `LogicalToPx(...)`
- `PxToLogical(...)`
- `AnchorLogicalToPx(...)`
- `ControlOuterBoundsLogical/Px(...)`
- `ControlVisualBoundsLogical/Px(...)`
- `ControlContentBoundsLogical/Px(...)`
- `ControlHitBoundsLogical/Px(...)`
- `ControlFocusBoundsLogical/Px(...)`
- `ControlFloatAnchorBoundsLogical/Px(...)`
- `ControlAnchorPx(...)`
- `TryGetSurfaceViewportPx(...)`
- `IsUsable(...)`

Evidence: `MASSystem/Application/Facade/MASApplicationWindowGeometry.vb`.

## Explicit exclusions

The following exist in source but are not public consumer surface:

- `MASRuntimeSizeProfileService` — `Friend` owner behind public facades.
- `MASLayoutEngine` and arrange/measure internals — `Friend` engine layer.
- `MASResponsiveLayoutProfile`, `MASResponsiveLayoutResolver`, `MASResponsiveLayoutThresholds` — `Friend` responsive infrastructure.
- Size/Layout diagnostic/audit types — `Friend` quality infrastructure.
- `LayoutRegions(...)` — `Friend` advanced retained layout path.

## Validation note

This page records a static source/project snapshot. Phase 2 of the user-documentation audit must regenerate this inventory from the current project and reconcile it with the compiled public surface before final release.