aegis_honeycomb 1.1.2

aegis_honeycomb: ^1.1.2 copied to clipboard

• Docs: Added Claude Code skill integration section to README and README_zh. Install the official skill with claude plugin install github:AegisLabsOrg/honeycomb-skill.

• Feature: Added update method to HoneycombContainer for easier functional state updates (highly recommended for immutable updates to List, Map, etc.).
• Docs: Added a dedicated section in README on how to correctly perform immutable updates with collections.

• Breaking Change / Architecture Upgrade: Implemented true Push-Pull reactivity model for Computed and SafeComputed nodes.
  • Glitch-Free: Solved the "Diamond Dependency" problem. Derived state is now lazily recomputed during read/watch phase rather than cascaded synchronously, ensuring sub-trees only execute once per render effectively banishing redundant rebuilds.
  • State change notifications (Push) and actual compute calls (Pull) are fully decoupled.
• Optimization: EagerComputed now debounces eager computations into a Microtask schedule rather than locking the main thread, resulting in ultra-smooth event loops across multiple rapid dependency tree changes.
• Test: Introduced diamond_dependency_test.dart and expanded existing boundary Edge Case tests ensuring absolute graph sorting integrity.

• Docs: Translated source code comments and example comments to English.
• Docs: Updated README to highlight "Context-Free Usage" and "Global Container" patterns.
• Example: Added ContextFreeDemo to example app.

• Feature: Enhanced Observability completely instrumented.
  • StateRef, Computed, Effect now report detailed lifecycle events to HoneycombDiagnostics.
  • Added debugKey to internal nodes to allow identifying Atoms in logs.
  • recompute logs now include execution duration and the dependency that triggered the update.
  • emit logs added for Effects.

• Refactor: HoneycombScope is now backed by a StatefulWidget. This ensures the HoneycombContainer instance persists correctly across widget tree rebuilds (e.g. parent updates, route changes), preventing accidental state loss.
• Optimization: HoneycombConsumer now performs precise dependency tracking, automatically cleaning up subscriptions for atoms not accessed during the current build.
• Improvement: Enhanced Hot Reload support for Computed values in the widget tree.

🎉 Initial Release #

Core Features

• StateRef - Mutable state atoms with auto-dispose policies
• Computed - Derived state with automatic dependency tracking
• EagerComputed - Immediately recomputes when dependencies change
• SafeComputed - Captures exceptions as Result<T> instead of throwing
• AsyncComputed - Async state management with AsyncValue<T>
• Effect - One-time events with drop/bufferN/ttl strategies

Flutter Integration

• HoneycombScope - Widget tree state container with override support
• HoneycombConsumer - Builder widget for watching state
• HoneycombListener - Side-effect listener for effects
• Context extensions - context.read(), context.watch(), context.listen()

Advanced Features

• Batch updates for performance optimization
• Scope/Override mechanism for dependency injection
• Hot reload support with reassemble()
• Pluggable diagnostics and logging system
• Multiple dispose policies: keepAlive, autoDispose, delayed