![\"FractoState](\"https://dll.nehonix.com/assets/FractoState/logo.png\"){kind=logo}
\n\n \n
\n
\n \n View FractoState Demonstration (MP4)\n \n
\n\n## Architectural Objectives\n\nTraditional state management patterns often encounter significant performance and maintainability limitations:\n\n1. **Context Overhead**: Dependency on high-level providers often results in unnecessary re-renders across the component tree.\n2. **Boilerplate Rigidity**: Redux-like architectures introduce significant cognitive overhead for routine state transitions.\n3. **Memory Latency**: Standard immutable patterns in JavaScript frequently require expensive deep-cloning operations.\n4. **Namespace Pollution**: Global state exposure increases the risk of side effects and non-deterministic mutations.\n\n## Core Engineered Solutions\n\nFractoState redefines state management via three architectural pillars:\n\n- **Isolated Memory Vault**: State is encapsulated within private closures, preventing unauthorized external mutations and ensuring data integrity.\n- **Atomic Proxy Engine**: Utilizes recursive Proxies to provide a direct mutation API while maintaining strict immutability and surgical update resolution under the hood.\n- **Direct Subscription Model**: Components subscribe directly to specific Vault keys, bypassing the React Context tree to ensure minimal O(1) render targeting.\n\n## Installation\n\n```bash\n# xfpm (recommended)\nxfpm install fractostate\n\n# standard package managers\nnpm install fractostate\nyarn add fractostate\npnpm add fractostate\n```\n\n## Quick Implementation\n\nExample of a decentralized cart state:\n\n```tsx\nimport { defineFlow, useFlow } from \"fractostate\";\n\n// ◈ Define the flow definition\nconst CartFlow = defineFlow(\"cart\", { items: [], total: 0 });\n\n// ◈ Interaction in any component\nfunction AddToCartButton({ product }) {\n const [, { ops }] = useFlow(CartFlow);\n\n return ; // ops.self.items._push(product)\n}\n\n// ◈ Focused reactivity\nfunction CartIcon() {\n const [cart] = useFlow(CartFlow);\n return {cart.items.length} units;\n}\n```\n\n## Engineering Highlights (v4)\n\nFractoState v4 introduces advanced primitives designed for enterprise-scale requirements, featuring our most optimized Surgical Engine to date.\n\n### Computed Flows\n\nReactive, read-only state nodes derived from source flows.\n\n- [Documentation: Computed Flows](https://fractostate.nehonix.com/docs/computed-flows)\n\n### Native Async Actions\n\nEncapsulated business logic with direct access to surgical operation proxies.\n\n- [Documentation: Async Actions](https://fractostate.nehonix.com/docs/native-async-actions)\n\n### Extensible Plugin Interface\n\nUnified API for state persistence, telemetry, and debugging.\n\n- [Documentation: Plugins](https://fractostate.nehonix.com/docs/plugins-and-devtools)\n\n### Surgical DevTools\n\nReal-time state inspector with zero-configuration overhead.\n\n- [Documentation: DevTools](https://fractostate.nehonix.com/docs/plugins-and-devtools#ghost-inspector-devtools)\n\n### Immediate Effects & Hydration\n\nAuto-executing side effects with dependency tracking and pre-mount hydration capabilities.\n\n- [Documentation: Effects](https://fractostate.nehonix.com/docs/immediate-effects)\n\n## Performance Benchmarks\n\nFractoState is engineered for high-throughput environments. Our latest Stress Test (v4) demonstrates how the **Surgical Engine v4** handles massive states with near-zero overhead.\n\n\n ![\"Operations](\"https://dll.nehonix.com/assets/FractoState/diag_ops_sec.png\")
\n
\n ![\"Performance](\"https://dll.nehonix.com/assets/FractoState/diag_perf_over.png\")
\n
\n ![\"Latency](\"https://dll.nehonix.com/assets/FractoState/diag_update_latency.png\")
\n