# XWUIBlockUI

Covers a region (or the whole viewport) with a dimming overlay to block interaction during a busy operation, optionally showing a spinner and a message. Unlike a modal backdrop, it can scope to just its host element when `fullScreen` is `false`. It reuses XWUISpinner for the loading indicator and sets `aria-busy` on the host. Toggle it at runtime with `setBlocked()` and update the caption with `setMessage()`; configure `showSpinner`, `spinnerSize`, and `baseZIndex`.

## Basic Usage

A dimming overlay scoped to its host panel with a spinner and a status message.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A dimming overlay scoped to its host panel with a spinner and a status message.
```

## Toggle Blocking At Runtime

Block the panel on demand with `setBlocked()` and `setMessage()`, then release it.

```example
file: examples/ToggleBlocked.ts
html: examples/ToggleBlocked.html
title: Toggle Blocking At Runtime
description: Block the panel on demand with setBlocked and setMessage, then release it.
```

## Full-screen bootstrap

Viewport-wide overlay while the shell hydrates (`fullScreen: true`, large spinner).

```example
file: examples/FullScreenBootstrap.ts
html: examples/FullScreenBootstrap.html
title: Full-screen bootstrap
description: fullScreen:true covers the viewport while the app shell hydrates.
```

## Message-only (no spinner)

Read-only or maintenance state with caption only - no spinner motion.

```example
file: examples/MessageOnly.ts
html: examples/MessageOnly.html
title: Message-only (no spinner)
description: showSpinner:false for read-only or maintenance overlays with caption only.
```

```api
```