Goldziher / Goldziher/interface-forge

Feature: Lazy Evaluation Ergonomics

Open
#46 0 comments 0 reactions 0 assignees View on GitHub
enhancement good first issue help wanted onlydust-wave
Dominant language
TypeScript
Stars
102
Forks
9
PR merge metrics
No merged PRs in 30d

Description

## Focused Scope

Improve lazy-evaluation ergonomics and documentation around the existing `use()` API.

## Proposed v1

- Document `use(async () => ...)` with `buildAsync()`.
- Add tests showing async `use()` resolves through `buildAsync()`.
- Ensure sync `build()` fails clearly when async lazy values are used.
- Optionally add `lazy` as an alias for `use` if the naming improvement is worth the public API surface.

## Out of Scope

- Field dependency graphs.
- `lazyIf()` or conditional DSLs.
- New relationship/association semantics.

Conditional values can already be expressed in the factory function through kwargs and hooks.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.