# XWUISuperPurchasing

Super-tier app shell for the Purchasing / Procurement domain, composing a single `purchasing` accordion group whose seven leaves lock the canonical procure-to-pay page-set (Dashboard, Purchase Orders, Requisitions, Suppliers, Contracts, Invoices, Reports). Because `industry/purchasing/` is still empty, `purchasing-dashboard` is the cold-start landing leaf and synthesises a four-KPI strip via `power/XWUIDashboard` (Open POs, Spend MTD SAR, Avg. Lead Time, On-time %), while every other leaf mounts an `XWUIEmpty` "Coming soon" placeholder. The menu tree and page registry are static, so a host can deep-link by menu-key, set `title` / `sidebarWidth` / `sidebarCollapsed`, pass `activeKey`, `locale`, `user` and `notifications` as data, or merge with sibling Super apps via `extraTree` / `extraPages` or `XWUISuperApp.merge()`.

## Basic Usage

Mounts the Purchasing shell standalone with a Procurement Manager identity, landing on the synthesized KPI dashboard with every procurement leaf reachable from the sidebar.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts XWUISuperPurchasing on its own, opening on the default purchasing-dashboard KPI strip while the other leaves stay placeholders.
```

## Merged With Accounting

Merges Purchasing with a stand-in Accounting Super app via `XWUISuperApp.merge()`, modelling the procure-to-pay (PO to invoice to ledger) story across two side-by-side accordion groups.

```example
file: examples/MergedWithAccounting.ts
html: examples/MergedWithAccounting.html
title: Merged With Accounting
description: Union-merges XWUISuperPurchasing with an AppAccountingDemo subclass into one host XWUISuperApp, still cold-landing on purchasing-dashboard.
```

## Requisitions (Arabic)

A buyer opens on the requisitions approval queue under Arabic / RTL, the badge showing 11 pending approvals.

```example
file: examples/RequisitionsArabic.ts
html: examples/RequisitionsArabic.html
title: Requisitions (Arabic)
description: Deep-links XWUISuperPurchasing onto purchasing-requisitions with locale ar, landing on the approval queue under RTL with an 11-notification badge.
```

## With Approvals Inbox

Extends Purchasing with an Approvals > My Approvals leaf via extraTree / extraPages, deep-linking onto a card listing POs awaiting sign-off.

```example
file: examples/WithApprovalsInbox.ts
html: examples/WithApprovalsInbox.html
title: With Approvals Inbox
description: Adds an Approvals > My Approvals leaf through extraTree / extraPages and deep-links onto an XWUICard listing three POs within the delegation limit.
```

```api
```