Skip to main content

flight_blackbox 0.2.0 copy "flight_blackbox: ^0.2.0" to clipboard
flight_blackbox: ^0.2.0 copied to clipboard

Deterministic in-app event-sourcing black box and crash-to-testWidgets synthesizer for Flutter applications.

Changelog #

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

0.2.0 #

Features & Improvements #

  • Modal Barrier & Occlusion Hit-Testing: Added visual paint-order visitIndex tracking and ModalBarrier hit-detection in SemanticResolver. Eliminates false positive hits on occluded background widgets when modal bottom sheets, alert dialogs, or overlay routes are open.
  • Atomic Tap & Navigation Lookahead: Implemented _findMatchingUpIndex in FlightSynthesizer to automatically couple taps with interleaved route transitions and breadcrumbs, eliminating gesture fragmentation and ensuring route animations settle cleanly.
  • Intelligent Off-Screen Lazy List Scrolling: Generated testWidgets tests automatically scroll lazy list items (ListView.builder, SliverList) into view via scrollUntilVisible targeting the topmost active scrollable before tapping.
  • Auto-Import & Test Harness CLI: Added -I / --import flag to bin/synthesize.dart with automatic detection of host project package:<name>/main.dart from pubspec.yaml.
  • API Ergonomics: Added FlightRecorder.instance.dumpSession() alias for snapshot().

0.1.0 #

Features #

  • Zero-Allocation Ring Buffer: $O(1)$ pre-allocated circular buffer (EventRingBuffer) for high-frequency gesture, navigation, network, and lifecycle events without GC overhead.
  • Deterministic Test Synthesizer: Pure-Dart CLI (dart run flight_recorder:synthesize) converting .flightlog recordings into reproducible testWidgets Dart test scripts.
  • Semantic Hit-Test Resolution: Walk render tree to resolve find.byKey, find.text, find.byType, and SemanticsNode.label instead of brittle screen coordinates.
  • Keyboard & IME Recording: Intercept flutter/textinput channel with real-time PII redaction and tester.enterText synthesis.
  • Platform Channel Replay Binding: Automatically stub MethodChannel invocations via PlatformChannelReplayBinding.installAll to eliminate MissingPluginException in headless test environments.
  • Pure-Dart Authenticated Encryption: AES-256 / ChaCha20 quarter-round cipher + HMAC-SHA256 authenticated encryption (.eflightlog) with PBKDF2 key derivation.
  • WebSocket Interceptor & Replay: Full bidirectional WebSocket tracking and in-process mock server (FlightWebSocketReplayServer).
  • Dependency Injection Scaffolding: TestHarnessBuilder generating test/flight_harness.dart with auto-detection for Riverpod, GetIt, Bloc, and Provider.
  • Diagnostic Floating Overlay: Draggable staging/dogfood pill (FlightRecorderOverlay) with real-time event inspector, export, and clipboard test synthesis.
  • Dual Replay Harness: Standalone FlightReplayServer with HttpOverrides for deterministic network fixture replay.
1
likes
150
points
99
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Deterministic in-app event-sourcing black box and crash-to-testWidgets synthesizer for Flutter applications.

Repository (GitHub)
View/report issues

Topics

#testing #debugging #crash-reporting #developer-tools #testwidgets

License

BSD-3-Clause (license)

Dependencies

args, flutter, flutter_test, path

More

Packages that depend on flight_blackbox