# XWUISuperEcommerce

Super-tier storefront-admin shell that composes the whole ecommerce console behind one mount. The single `ecommerce` group holds seven leaves: Dashboard wires a real `XWUIDashboard` (Orders Today / Revenue / AOV / Active Carts KPIs plus four empty-bodied widgets) and is the only `default: true` leaf, while Orders / Products / Customers / Inventory / Discounts / Reports each mount a uniform `XWUIEmpty` placeholder with contextual copy so every menu key resolves to a live page and no click dead-ends. The static `menuTree()` + `pages()` accept `title` (default "Ecommerce"), `sidebarWidth`, `activeKey`, `user`, `locale`, and `notifications`; a host wires real data by subclassing and overriding `pages()`, or merges an analytics Super app via `extraTree` / `extraPages` or `XWUISuperApp.merge()`.

## Basic Usage

Mounts the Ecommerce shell standalone with a Store Admin identity, landing on the KPI dashboard with the six placeholder leaves reachable from the sidebar.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts XWUISuperEcommerce on its own, opening on the default-flagged Dashboard leaf (KPI ribbon + four empty widget cards).
```

## Merged With Inventory

Union-merges Ecommerce with an inline `XWUISuperInventoryStub` via `XWUISuperApp.merge()`, then strips the duplicate Ecommerce branch from the merged tree so the host's own `menuTree()` does not render the accordion twice.

```example
file: examples/MergedWithInventory.ts
html: examples/MergedWithInventory.html
title: Merged With Inventory
description: Merges XWUISuperEcommerce with a stand-in Inventory Super-app, feeding only the inventory branch back through extraTree to avoid a doubled Ecommerce group.
```

## Orders Fulfilment

Deep-links straight to the `ecom-orders` queue so warehouse staff land on live orders, with a 12-order unfulfilled badge in the header.

```example
file: examples/OrdersFulfilment.ts
html: examples/OrdersFulfilment.html
title: Orders Fulfilment
description: Opens directly on ecom-orders so fulfilment staff land on the live orders queue, with a header badge of 12 unfulfilled orders.
```

## With Live Chat

Adds a host-owned "Support" group through extraTree / extraPages, landing on a live-chat card without subclassing the shell.

```example
file: examples/WithLiveChat.ts
html: examples/WithLiveChat.html
title: With Live Chat
description: Extends the Ecommerce nav with a support-chat leaf via extraTree / extraPages that mounts an XWUICard standing in for a customer live-chat page.
```

```api
```