# XWUISuperFinance

Super-tier app shell for the finance / treasury domain, composing `power/XWUIDashboard` and the five `industry/finance` price-series charts (Stock, Stock Overlay, Candlestick, Candlestick + Volume, OHLC) under a single `fin` accordion. The cold-start landing leaf is `fin-dashboard`, a KPI ribbon of Cash on Hand / Receivables / Payables / Burn Rate over four mini-charts; the wired Treasury / Accounts page surfaces a stock chart while Budgets, Cash Flow, Forecasts, and Reports reserve stable `fin-*` menu keys behind `XWUIEmpty` placeholders until real treasury components ship. The static `menuTree()` / `pages()` let a host deep-link by menu-key, override leaves via `extraTree` / `extraPages`, or fold in a sibling finance-family Super app with `XWUISuperApp.merge()`; `title`, `sidebarWidth`, `activeKey`, `user`, `locale`, and `notifications` tune the inner `XWUIShellApp`.

## Basic Usage

Mounts the Finance shell standalone with a Treasury Analyst identity, omitting `activeKey` so the base class lands on the default `fin-dashboard` leaf.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Mounts XWUISuperFinance on its own with a Treasury Analyst identity, opening on the default fin-dashboard KPI page.
```

## Merged With Accounting

Folds Finance and `XWUISuperAccounting` into one shell with `XWUISuperApp.merge()`, showing both top-level groups side-by-side while landing on the finance dashboard.

```example
file: examples/MergedWithAccounting.ts
html: examples/MergedWithAccounting.html
title: Merged With Accounting
description: Merges XWUISuperFinance with XWUISuperAccounting into one host XWUISuperApp, keeping fin-* and acc-* deep links working under disjoint namespaces.
```

## Candlestick Desk

Deep-links straight to the candlestick + volume chart leaf so a trader lands on the price/volume view instead of the dashboard.

```example
file: examples/CandlestickDesk.ts
html: examples/CandlestickDesk.html
title: Candlestick Desk
description: Opens directly on fin-chart-candlestick-vol so a markets analyst lands on the combined candlestick + volume chart, with a 280px sidebar.
```

## Treasury (Arabic)

Deep-links straight to the Treasury / Accounts view under the Arabic locale, flipping the shell to RTL for a CFO.

```example
file: examples/TreasuryArabic.ts
html: examples/TreasuryArabic.html
title: Treasury (Arabic)
description: Opens directly on fin-treasury with locale 'ar' so the shell mirrors to RTL, prefers the user's nameAr, and shows a 2-alert notification badge.
```

```api
```