# XWUISuperInventory

Super-tier app shell for the inventory / stock-management domain, locking the public menu-key contract while `industry/inventory/` is still empty: a single `inventory` group holds the dashboard plus six placeholder leaves mirroring the canonical stock-management page-set (Stock, Warehouses, Transfers, Adjustments, Suppliers, Reports). The cold-start landing leaf is `inv-dashboard`, a synthesized `power/XWUIDashboard` KPI strip (SKUs in Stock / Low Stock Alerts / Backorders / Avg. Turnover); every other leaf mounts `XWUIEmpty` with shared "Coming soon" copy until real page-classes land. The static `menuTree()` / `pages()` let a host deep-link by menu-key, override leaves via `extraTree` / `extraPages`, or fold in a sibling Super app such as `XWUISuperEcommerce` with `XWUISuperApp.merge()`; `title`, `sidebarWidth`, `activeKey`, `user`, `locale`, and `notifications` tune the inner `XWUIShellApp`.

## Basic Usage

Mounts the Inventory shell standalone with a Warehouse Manager identity, landing on the synthesized KPI dashboard with every other leaf showing its placeholder.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts XWUISuperInventory on its own with a Warehouse Manager identity, opening on the synthesized inv-dashboard KPI strip.
```

## Merged With Ecommerce

Union-merges Inventory with `XWUISuperEcommerce`, mounting Inventory itself as the host class and filtering the duplicate `inventory` branch out of the merged tree so the Ecommerce leaves nest under one Inventory group.

```example
file: examples/MergedWithEcommerce.ts
html: examples/MergedWithEcommerce.html
title: Merged With Ecommerce
description: Merges XWUISuperInventory with XWUISuperEcommerce, hosting from XWUISuperInventory and feeding only the Ecommerce branch via extraTree to avoid rendering the inventory accordion twice.
```

## Stock Levels (Arabic)

Deep-links straight onto the `inv-stock` levels grid under an Arabic RTL locale with a 7-alert low-stock badge.

```example
file: examples/StockLevelsArabic.ts
html: examples/StockLevelsArabic.html
title: Stock Levels (Arabic)
description: Cold-lands XWUISuperInventory on the inv-stock leaf in RTL with a Khalid Saleh (خالد صالح) identity and 7 low-stock notifications.
```

## With Reorder Alerts

Bolts a custom "Alerts" group with a Reorder Points page onto the Inventory shell via `extraTree` / `extraPages` and opens on it.

```example
file: examples/WithReorderAlerts.ts
html: examples/WithReorderAlerts.html
title: With Reorder Alerts
description: Extends XWUISuperInventory with an Alerts / Reorder Points leaf backed by an XWUICard and deep-links straight to the reorder-point card.
```

```api
```