# RefArray.prepend

Prepend a value to the current state of a RefArray.

## Signatures

```ts
export declare const prepend: {
    <A>(value: A): <E, R>(ref: RefArray<A, E, R>) => Effect.Effect<ReadonlyArray<A>, E, R>;
    <A, E, R>(ref: RefArray<A, E, R>, value: A): Effect.Effect<ReadonlyArray<A>, E, R>;
};
```

## Why

Expresses prepend as one ordered array transition; readers never observe the intermediate
collection used to build the result.

## Ownership and lifetime

Running prepend performs one serialized array transition and resolves with its committed value.
It acquires no resource; failures and services remain those of the source ref.