# XWUIAuthLogin

A page-level login shell that mirrors KEYSTONE's `/login` view: a brand header (logo via `XWUILogo`, brand text, tagline) above an email + password form, an optional "remember me" checkbox, and a forgot-password / create-account link row. The form chrome itself is delegated to the headless `power/XWUIAuthSignIn` block (selected with `block` 1-3); `showRememberMe`/`showForgotPassword`/`showRegisterLink` toggle the extras, `onSubmit()` receives the `{ email, password, rememberMe }` payload, and `setError()` populates the alert slot.

## Basic Usage

A KEYSTONE-branded login page (block 1) with the tagline "Encrypted at rest with KEYSTONE", remember-me, forgot-password, and register links enabled, and an `onSubmit` handler logging the payload.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A KEYSTONE-branded login card with email/password, remember-me, and forgot/register links, wired to onSubmit.
```

## Split Branded

A `block: 2` split-layout login with a logo mark, a pre-filled returning-user email, the register link hidden for invite-only access, and an error surfaced in the alert slot.

```example
file: examples/SplitBranded.ts
html: examples/SplitBranded.html
title: Split Branded
description: A split-layout (block 2) login with a circular logo mark, pre-filled email, no register link, and a stale-session error.
```

## Minimal Inline

A `block: 3` inline login stripped to two fields for embedding in a header, with remember-me and the register link turned off.

```example
file: examples/MinimalInline.ts
html: examples/MinimalInline.html
title: Minimal Inline
description: A compact inline (block 3) email/password login for an embedded widget, with only a forgot-password link.
```

```api
```