# failure

Creates a failed state while preserving the complete Effect Cause.

## Signatures

```ts
export declare const failure: <E>(cause: Cause.Cause<E>, progress?: Progress) => Failure<E>;
```

## Why

Accepting `Cause` prevents typed failures, defects, and interruption from being collapsed into one error value.

## Ownership and lifetime

This pure function acquires no resources; the returned wrapper retains the supplied persistent Cause.

## Examples

```ts
import { failure } from "@typed/async-data"
import { Cause } from "effect"
const state = failure(Cause.fail("offline"))
```
