sync-construction-async-property-ui-render-gate-pattern

What problem does it solve?

Export a client that initializes asynchronously by attaching the async work to the instance, enabling synchronous access to the API while background tasks run.

Core Features & Use Cases

• Synchronous export with attached async work: The instance is exported immediately and exposes sync methods, with asynchronous initialization tracked on a property.
• UI render gate: Consumers can await a ready promise (whenSynced) at the root to ensure readiness before rendering children.
• Composable initialization: Use a withCapabilities builder to attach specific async tasks (e.g., persistence, data loading) without blocking construction.

Quick Start

Create your client instance and await its whenSynced in the root UI gate to render children.