bloc_signals_devtools 0.1.1

Dedicated Flutter DevTools extension UI for inspecting BlocSignal containers.

⚡ bloc_signals_devtools

"With the rigor of Bloc and the flex and speed of Signal"

Dedicated Flutter DevTools extension UI for inspecting BlocSignal and CubitSignal containers, tracing event-to-transition timelines, inspecting state diffs, and warning against memory leaks.

---

🌐 Ecosystem Packages

Package	Purpose	Pub.dev Link
bloc_signals	Core pure-Dart state containers, event registry, & VM Service telemetry	📦 pub.dev
bloc_signals_flutter	Flutter UI widgets (BlocSignalProvider, BlocSignalBuilder, BlocSignalListener, BlocSignalConsumer, BlocSignalSelector)	📦 pub.dev
bloc_signals_riverpod	Bidirectional Riverpod interop adapters (toBlocSignal(ref), toProvider())	📦 pub.dev
bloc_signals_hydrate	Persistent state storage (HydratedCubitSignal, HydratedBlocSignal)	📦 pub.dev
bloc_signals_devtools	Dedicated Flutter DevTools extension inspector UI	📦 pub.dev
bloc_signals_test	Declarative unit testing helpers (blocSignalTest)	📦 pub.dev
bloc_signals_lint	Static analysis lints & IDE quick-fixes	📦 pub.dev
otel_bloc_signals	OpenTelemetry tracing observers	📦 pub.dev

---

⚡ Key Features

• 🌳 Instance Tree View: Searchable list of active container instances, state values, types, and closure status.
• ⏱️ Timeline Trace Panel: Chronological timeline mapping events ➔ transitions ➔ state updates per container instance.
• 🔀 State Diff Inspector: Interactive object diff viewer highlighting currentState vs nextState.
• 🚨 Leak Detector & Warnings: Alert badge displaying active vs closed container counts and retain warnings.

---

🚀 Getting Started

Add bloc_signals_devtools to your pubspec.yaml:

dev_dependencies:
  bloc_signals_devtools: ^0.1.0

---

💡 Usage Example

import 'package:bloc_signals_devtools/bloc_signals_devtools.dart';
import 'package:flutter/material.dart';

Widget buildInspector(
  List<Map<String, dynamic>> instances,
  List<Map<String, dynamic>> history,
) {
  return BlocSignalsDevToolsExtension(
    instances: instances,
    history: history,
  );
}

---

📜 License

MIT License. See LICENSE for details.