Codex Pets React: Embed Codex pet spritesheets in React apps.

Codex Pets React is a specialized library that addresses a niche but technically demanding use case: rendering and managing stateful, animated spritesheets within a React environment. Its core strength lies in encapsulating the complexity of character animation—including frame timing, atlas mapping, and state persistence—into predictable, functional components. The toolkit provides `SpriteAnimator` for simple playback, but the main value comes from `PetWidget`, which handles the entire rendering surface, incorporating pinning, fixed coordinates, and event tracking. The library architecture is highly commendable for its reactive approach to animation. By exposing `usePetController` and `petReducer`, it allows developers to treat the pet's behavior (movement, state, animation) as a pure, manageable application state. This is crucial for large-scale web applications where pet actions must reliably trigger corresponding visual updates, whether through `petDispatch` calling `animation.play` or setting `position` coordinates. This adherence to a state management pattern significantly elevates its utility beyond a simple asset viewer. For advanced interactions, the inclusion of gesture tracking via `usePetDragGestureAnimations` is a sophisticated addition. Instead of just accepting discrete actions, the system observes physical drag gestures and translates them into follow-up animation dispatch calls. This level of integration moves the component from being merely decorative to being genuinely interactive and responsive to user input, greatly enhancing the perceived quality and complexity of the built application. While the use case (Codex pets) is inherently specialized, the underlying patterns are reusable. The technical model—a dedicated widget receiving props for `src`, `atlas`, and state-driven action handlers—is highly robust. The necessary prerequisite of manually copying pet asset directories (`cp ~/.codex/pets/tater ...`) while inconvenient, underscores that the tool is designed for integration into existing, structured frontend asset pipelines, not plug-and-play simplicity. It is a solid, engineer-grade utility for those who need rigorous control over sprite state.