⚡ BlocSignal "With the rigor of BLoC and the flex and speed of Signals" A state management framework for Dart and Flutter that bridges the Business Logic Component (BLoC) pattern with Rody Davis's signals (v7) primitives.

The BlocSignal monorepo consists of 10 modular packages:

Package	Version	Description
bloc_signals		Core pure Dart reactive state primitives bridging BLoC & Signals
bloc_signals_flutter		Flutter UI bindings, providers, builders, listeners & selectors
bloc_signals_jaspr		Jaspr web component integration and state binding for BlocSignal
bloc_signals_riverpod		Bidirectional Riverpod 2/3 interop adapters & provider extensions
bloc_signals_hydrate		Automated synchronous local state persistence & hydration
bloc_signals_replay		Undo & redo state history tracking for CubitSignal and BlocSignal
bloc_signals_otel		OpenTelemetry tracing and span generation for state transitions
bloc_signals_devtools		Universal DevTools telemetry observer using dart:developer
bloc_signals_test		Declarative unit testing utilities (blocSignalTest)
bloc_signals_lint		Custom analyzer lint rules & automated IDE quick-fixes

• 🚀 Synchronous State Propagation: Eliminates microtask-queue latency found in Stream-based BLoC implementations.
• 🎯 Fine-Grained Reactivity: Leverages Rody Davis's signals v7 primitives for highly performant and precise rebuilds.
• 🧹 Automatic Lifecycle Management: Automatically manages and tears down effects and listeners via SignalModel integration on close.
• 🔍 Global Observation: Hook in a BlocSignalObserver to easily log, trace, and monitor events and transitions globally.
• 🔀 Automatic De-duplication: State transitions are automatically de-duplicated using standard == equality or custom equals.
• 🛠️ DevTools & VM Service RPC: Remote action dispatching, trace panels, diff inspectors, and leak detection via bloc_signals_devtools.
• 💾 State Persistence: Synchronous initial state hydration across app restarts via bloc_signals_hydrate.
• ↩️ Undo & Redo Replay: Automatic state history tracking, stack limits, and state filtering via bloc_signals_replay.
• 📊 OpenTelemetry Tracing: Built-in support for distributed tracing with standard OpenTelemetry spans via bloc_signals_otel.
• 🌁 Universal Interoperability: Seamlessly adapt between BLoC, Riverpod, Provider, and Flutter Listenable primitives.

BlocSignal combines two foundational pillars of the Dart & Flutter state management ecosystem:

• BLoC Architecture (bloclibrary.dev): Event-driven state machine discipline, state separation, and enterprise observability (BlocSignalObserver).
• Signals Primitives (signals.dart): Fine-grained reactive dependency graphs and zero-latency value holding.

• ⚡ Synchronous vs. Asynchronous Emission: Unlike classic package:bloc which dispatches state changes on microtask-queue Streams, BlocSignal updates propagate synchronously. Calling emit(newState) triggers downstream calculations and widget rebuilds in the exact same frame.
• 🔑 Named Constructor Initial State (initialState:): Constructors require the named parameter initialState: (for example, : super(initialState: 0)), unlike Felix BLoC's positional : super(0).
• 📊 Explicit State Value Access (stateValue): Use stateValue (or state.value) to read raw StateType values in methods or event handlers (for example, emit(stateValue + 1)), while state exposes ReadonlySignal<StateType> for reactive signal bindings.
• 🎯 context.select<B, R> 2-Argument Generic Signature: Unlike Riverpod (3 generic arguments) or classic flutter_bloc, context.select<B, R> takes 2 generic type parameters (<Bloc, SelectedType>) and passes the bloc instance directly to the callback: (bloc) => bloc.stateValue.property.
• 📦 Zero RepositoryProvider Bloat: Dependency injection in BlocSignal is handled directly via BlocSignalProvider (or Riverpod/Jaspr context providers) without forcing a separate RepositoryProvider wrapper.
• 🔒 Streamless Event Concurrency: Event concurrency transformers (droppable, sequential, restartable, Mutex) run via pure Dart higher-order functions without stream allocations or Rx dependencies.

• Architectural Decision Matrix: State modeling rubric comparing raw Signals, CubitSignal, BlocSignal, and mixins.
• Migration Guide: Moving from classic package:bloc / package:flutter_bloc to BlocSignal.
• Riverpod Interop & Migration: Converting between Riverpod providers and BlocSignal.
• Universal Interoperability Guide: State bridge across BLoC, Riverpod, and Provider.
• State Hydration: Persistent state storage and initial hydration semantics.
• DevTools Extension: DevTools inspector, timeline trace panel, and memory leak alerts.
• Static Analysis & Lints: Analyzer rules and IDE diagnostics.
• OpenTelemetry Telemetry: Distributed tracing spans and observer setup.

This repository includes a pre-packaged AI Agent Plugin & Skill bundle (bloc-signals) containing architectural best practices, lifecycle contracts, and migration guides for AI coding assistants (such as Claude Code, Antigravity, Gemini, Cursor, or Codex):

• Skill Bundle: plugins/bloc-signals/skills/bloc-signals/
• Marketplace Manifests: Available via .claude-plugin and .agents/plugins marketplace definitions.
• Validation: Run dart run tool/validate_agent_plugin.dart to verify marketplace catalogs and skill bundle integrity.

BlocSignal is heavily inspired by and builds upon the incredible work of:

• Felix Angelov and the original bloc / flutter_bloc libraries.
• Rody Davis and the signals library.
• Remi Rousselet and Riverpod.