# XWUISuperAuth

Super-tier shell for the identity / authentication domain: its static `menuTree()` and `pages()` compose a single `auth` group (icon `shield`) of nine leaves into a KEYSTONE-style identity-admin app - a synthesised KPI Dashboard (`power/XWUIDashboard`: Total Users, Active Today, Pending Invites, Expiring Keys), the two end-user auth surfaces `industry/auth/XWUIAuthLogin` and `XWUIAuthRegister` (embedded so an operator can QA them in-shell, with KEYSTONE-branded defaults), the two admin grids `XWUIAuthUsersAdmin` (a four-row seed where `u-04` is also `currentUserId`) and `XWUIAuthKeyAdmin`, plus four forward-compatible `XWUIEmpty` placeholders - Sessions, Roles, Audit Log and Settings - that lock the menu-key contract. The Dashboard leaf is the `meta.default: true` cold-start landing; every key is namespaced `auth-*` so a merge stays collision-free. Hosts adjust `conf_comp.title` (default `Auth`) / `sidebarWidth` / `sidebarCollapsed`, set the footer identity via `data.user`, and merge siblings through `extraTree` / `extraPages` or `XWUISuperApp.merge()`.

## Basic Usage

Mounts the Auth shell standalone with an Identity Admin identity (English + Arabic name) on the synthesised KPI dashboard, with the four real auth components and four placeholders wired into their leaves.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Stands XWUISuperAuth up on its own with activeKey auth-dashboard, landing on the four-KPI strip while login, register, users and keys plus the four placeholder leaves stay reachable.
```

## Merged With DB

Folds Auth with an inline `AppDBDemo` (stand-in for the upcoming `XWUISuperDB`, sharing its seven-leaf menu-key contract) via `XWUISuperApp.merge()`, mounting the combined descriptor on a host `XWUISuperApp`.

```example
file: examples/MergedWithDB.ts
html: examples/MergedWithDB.html
title: Merged With DB
description: Union-merges XWUISuperAuth with a placeholder Database Super app into one host XWUISuperApp via extraTree/extraPages, opening on auth-dashboard with the Database group beneath the Auth group.
```

## Login Entry Point

Deep-links straight onto the Login page leaf - the unauthenticated landing - with a branded square logo.

```example
file: examples/LoginEntryPoint.ts
html: examples/LoginEntryPoint.html
title: Login Entry Point
description: activeKey auth-login opens the shell on the sign-in surface with a square text-mark logo.
```

## Arabic RTL - Audit Log console

A security console localized for Arabic, landing on the Audit Log leaf with an open-alerts badge and persisted layout.

```example
file: examples/AuditConsoleArabic.ts
html: examples/AuditConsoleArabic.html
title: Arabic RTL - Audit Log console
description: locale 'ar' mirrors the shell and lands on auth-audit with an Arabic admin name, notifications badge and persistLayout.
```

```api
```