> For AI agents: the complete documentation index is available at https://massaman.dev/llms.txt, the full documentation bundle is available at https://massaman.dev/llms-full.txt.

# todo

Marks a code path you intend to implement later and throws if execution reaches it.

```typescript
return todo('waiting on schema decision')
```

## Usage

### `todo(message?)`

Use `todo` as an explicit, type-safe placeholder while work is incomplete. Its `never` return type allows it in any expression position, but it always throws at runtime. Use [`unimplemented`](https://massaman.dev/reference/control/unimplemented.md) for intentionally unsupported behavior and [`unreachable`](https://massaman.dev/reference/control/unreachable.md) for logically impossible paths.

```typescript
import { todo } from 'massaman'
// or:  import { todo } from 'massaman/control'

function parseConfig(raw: string): Config {
  return todo('waiting on schema decision')
}
```

#### Parameters


messagestringoptional

optional context appended to the thrown error message.

#### Returns

never returns; the function always throws.

```typescript
never
```

#### Throws

An `Error` with `not yet implemented`, optionally followed by `message`.

## See also

- [`unimplemented`](https://massaman.dev/reference/control/unimplemented.md) — intentionally unsupported behavior
- [`unreachable`](https://massaman.dev/reference/control/unreachable.md) — logically impossible behavior
