# XWUINonIdealState

A centered empty / error / zero-data state with an icon, title, description, and an optional action slot (Blueprint NonIdealState equivalent). Use it for "no results", "nothing here yet", or failure placeholders. Lay it out `vertical` (default) or `horizontal` via `layout`; the `icon` data accepts an image URL/path, a raw markup string, or an `HTMLElement`, and `action` takes a button or any element to offer a next step.

## Usage

```ts
import { XWUINonIdealState } from './XWUINonIdealState';

const retry = document.createElement('button');
retry.textContent = 'Try again';

const state = new XWUINonIdealState(
  container,
  {
    icon: '/icons/empty.svg',
    title: 'No results found',
    description: 'Try adjusting your filters.',
    action: retry,
  },
  { layout: 'vertical' }
);
```

## Basic Usage

A vertical empty-state placeholder with an emoji icon, title, and short description.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: A vertical empty-state placeholder with an emoji icon, title, and short description.
```

## Search Empty

A "no search results" state with an icon and a real action button that clears the active filters.

```example
file: examples/SearchEmpty.ts
html: examples/SearchEmpty.html
title: Search Empty
description: A "no search results" state with an icon and a real action button that clears the active filters.
```

## Error State

A horizontal failure placeholder with a warning icon, error copy, and a retry action button.

```example
file: examples/ErrorState.ts
html: examples/ErrorState.html
title: Error State
description: A horizontal failure placeholder with a warning icon, error copy, and a retry action button.
```

```api
```