Theseus

Welcome to Theseus, a robust solution for managing application state with clarity and efficiency. Designed with modern JavaScript applications in mind, Theseus stands out for its fluent state manipulation, ease of compliance, and intelligent typing capabilities.

Key Concepts

Theseus is built around several core concepts that differentiate it from other state management libraries:

• Evolvers: Inspired by the idea of evolving application state, Evolvers in Theseus provide a structured way to define how state changes in response to actions. They encourage a deterministic and predictable state transition model, making state management more intuitive and less error-prone.

• Refineries: Complementing Evolvers, Refineries allow for the transformation and validation of state transitions. They ensure that state changes are not only predictable but also conform to defined constraints and validations, enhancing the robustness of your application.

• Fluent State Management: Theseus introduces a fluent interface for state management, making the code more readable and expressive. This approach allows developers to chain state operations in a clear and logical sequence.

Why Theseus?

Compared to other state management libraries, Theseus offers:

• Automatic Type Inference: Theseus smartly infers types, reducing the boilerplate code typically associated with maintaining types for application state, actions, and reducers.

• Modular Architecture: The library's design encourages a modular approach to state management, making it easier to scale and maintain large applications.

• Enhanced Debugging: With built-in support for logging and state transition tracing, Theseus simplifies the debugging process, helping developers identify and fix issues faster.

Getting Started

Installation

npm install theseus-js

yarn add theseus-js

pnpm install theseus-js

Usage

See the tutorial for a walkthrough!

Tutorial

To help you get started with Theseus, we've created a comprehensive tutorial that covers the core concepts, features, and best practices for using the library.

Link to Tutorial

Simple Example

For a more hands-on introduction to Theseus, we've created a simple example that demonstrates the basic features of the library: a tic-tac-toe game.

Link to Tic-tac-toe Example

Building and Contributing

Theseus is an open-source project, and we welcome contributions from the community. Whether it's adding new features, fixing bugs, or improving documentation, your contributions are invaluable to making Theseus better for everyone.

Setting Up for Development

1. Clone the repository.
2. Run pnpm install && pnpm prepare to install dependencies and prepare development.
3. Use pnpm test to test the library.
4. Use pnpm build to compile the library.

License

Theseus is MIT licensed. For more details, see the LICENSE file.