# XWUISuperEmail

Super-tier Gmail-shaped 3-pane email shell: the sidebar contributes pane #1 (the folder tree) and each folder leaf builds panes #2 + #3 - `XWUIInbox` list on the left, detail pane on the right. Inbox / Starred / Sent / Spam / Trash all reuse one folder page-class differing only by `XWUIInbox` filter and empty-state copy; Drafts swaps the detail pane's `XWUIEmpty` for `XWUIMailComposer` so the composer is reachable from the menu, and Labels / Settings are `XWUIEmpty` "Coming soon" placeholders. `email-inbox` is the `meta.default` landing, while a synthesised `XWUIDashboard` (Unread / Today / Total this week, computed from the seed) lives off-sidebar under `email-dashboard` for hosts that prefer to land on metrics via `activeKey`. The static `menuTree()` + `pages()` honor `title` (default "Email"), `sidebarWidth`, `user`, `locale`, and `notifications`, and merge with sibling Super apps via `extraTree` / `extraPages` or `XWUISuperApp.merge()`.

## Basic Usage

Mounts the Email shell standalone with an Ada Lovelace identity and an unread badge, landing on the Inbox folder's list + detail view with the full Gmail-shaped folder tree in the sidebar.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts XWUISuperEmail on its own with activeKey email-inbox, opening on the 3-pane mailbox; pass email-dashboard to land on the KPI metrics view instead.
```

## Merged With Chat

Union-merges Email with an inline `XWUISuperChatStub` (one Channels leaf) via `XWUISuperApp.merge()`, mounting the combined descriptor into a base `XWUISuperApp` so an "Email" group and a "Chat" group share the sidebar.

```example
file: examples/MergedWithChat.ts
html: examples/MergedWithChat.html
title: Merged With Chat
description: Merges XWUISuperEmail with a stand-in Chat Super-app into one host shell via extraTree / extraPages, opening on email-inbox.
```

## Drafts (Arabic)

Deep-links straight to the Drafts folder under the Arabic locale, flipping the 3-pane shell to RTL so an Arabic user opens on their unsent drafts.

```example
file: examples/DraftsArabic.ts
html: examples/DraftsArabic.html
title: Drafts (Arabic)
description: Opens directly on email-drafts with locale 'ar' so the shell mirrors to RTL, prefers the user's nameAr, and shows a 1-unread badge.
```

## Starred Focus

A focused triage session that opens on the Starred folder with the sidebar collapsed to maximize the reading pane.

```example
file: examples/StarredFocus.ts
html: examples/StarredFocus.html
title: Starred Focus
description: Opens directly on email-starred with sidebarCollapsed true and a 0-unread badge, a distraction-free view over just the starred mail.
```

```api
```