# wait

`wait(duration)` returns an immutable program that advances local time without
writing signals. Output writer leases remain held across waits in an active
composed run.

Related type: [`PibblAnimationProgram`](/reference/types/canvas-runtime/#pibblanimationprogram).

## API details from source

<span id="api-wait"></span>

Adds finite nonnegative local time without writing an output.

```ts
wait: (duration: number) => PibblAnimationProgram
```

Related API: [wait](/reference/functions/wait/), [PibblAnimationProgram](/reference/types/canvas-runtime/#pibblanimationprogram).

### Parameters

- **`duration`** — Delay in milliseconds.

### Returns

A program that advances time without writing a value. See [PibblAnimationProgram](/reference/types/canvas-runtime/#pibblanimationprogram).

### See also

[PibblAnimationProgram](/reference/types/canvas-runtime/#pibblanimationprogram)

[View source — packages/core/src/lib/animation/program.ts:866](/source/packages/core/src/lib/animation/program-ts/#L866)

## Implementation guidance for agents

Read the [Animation and scheduling companion](/agents/topics/animation/) for ownership, adaptation, failure modes, and verification. [Agent start](/agents/) provides the version-selection workflow.

## Complete minimal examples

- [Compose keyframes and springs](/minimal-examples/animation/composition/): Run two independent tracks together, then mark, wait, and repeat. [Plain source](/minimal/animation/composition.tsx)
## Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.