flight_blackbox 0.2.0
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
visitIndextracking andModalBarrierhit-detection inSemanticResolver. Eliminates false positive hits on occluded background widgets when modal bottom sheets, alert dialogs, or overlay routes are open. - Atomic Tap & Navigation Lookahead: Implemented
_findMatchingUpIndexinFlightSynthesizerto 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
testWidgetstests automatically scroll lazy list items (ListView.builder,SliverList) into view viascrollUntilVisibletargeting the topmost active scrollable before tapping. - Auto-Import & Test Harness CLI: Added
-I/--importflag tobin/synthesize.dartwith automatic detection of host projectpackage:<name>/main.dartfrompubspec.yaml. - API Ergonomics: Added
FlightRecorder.instance.dumpSession()alias forsnapshot().
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.flightlogrecordings into reproducibletestWidgetsDart test scripts. - Semantic Hit-Test Resolution: Walk render tree to resolve
find.byKey,find.text,find.byType, andSemanticsNode.labelinstead of brittle screen coordinates. - Keyboard & IME Recording: Intercept
flutter/textinputchannel with real-time PII redaction andtester.enterTextsynthesis. - Platform Channel Replay Binding: Automatically stub
MethodChannelinvocations viaPlatformChannelReplayBinding.installAllto eliminateMissingPluginExceptionin 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:
TestHarnessBuildergeneratingtest/flight_harness.dartwith 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
FlightReplayServerwithHttpOverridesfor deterministic network fixture replay.