React Hook Writing Guide

Design principles for writing React hooks. Each section covers What + Why.

Treat C1 and C7 as project conventions rather than universal React rules. React itself allows tuple returns and positional arguments, but this philosophy prefers objects for extensibility and self-documenting APIs.

1. API Design

Return values (C1): Always return objects. Even single values use { value }. Why: Named fields, order-independent, extensible without breaking changes.