# XWUIProjectPortfoliosPage

A portfolio-overview page (extends `XWUIShellPage`) that loads portfolios and plans together via `api.listPortfolios()` + `api.listPlans()` and groups every plan under its parent portfolio. Shell-page fields such as `description` and `breadcrumbs` frame the rollup for different audiences and let it nest inside a navigation hierarchy.

## Basic Usage

Mounts the portfolio overview against `#app` with a mock `IProjectWorkApi`, grouping plans by portfolio.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Portfolio list grouping multiple work plans from the mock API.
```

## Executive Rollup

Frames the grouped-by-portfolio view for a leadership review with an executive-flavoured description.

```example
file: examples/ExecutiveRollup.ts
html: examples/ExecutiveRollup.html
title: Executive Rollup
description: A leadership rollup of every initiative grouped by portfolio, framed as a recurring status read.
```

## Nested Navigation

Embeds the portfolios view deep in a shell with `breadcrumbs` back to the workspace root and an `onBreadcrumbSelect` handler.

```example
file: examples/NestedNavigation.ts
html: examples/NestedNavigation.html
title: Nested Navigation
description: Home / Broadcast Ops crumbs with onBreadcrumbSelect sit above the grouped portfolio view.
```

```api
```