ispectify_bloc

Added

• Layout inspector breadcrumb: The selected widget's hit-test ancestor chain (Row, Column, Stack, Padding, SizedBox, Align, and other meaningful render objects) is now surfaced as horizontally scrollable chips under the panel title. Tap any chip to re-target the inspector without re-tapping the screen.

Improvements

• Breadcrumb navigation: Auto-scrolls the selected chip into view on every selection change, and uses clamping scroll physics so the list never overscrolls or bounces.

Bug Fixes

• Layout inspector - icon selection inside chips: Material ActionChip, Chip, FilterChip, and InputChip previously routed every tap to the label slot, hiding the avatar Icon from the inspector path. Tapping the avatar now correctly selects it.

Added

• The log viewer app bar now surfaces aggregate log statistics and a filter count badge, so active filters and totals are visible without opening the filter sheet.
• The JSON viewer breadcrumb bar auto-scrolls to the end as you drill in, keeping the current path segment in view on deep structures.

Improvements

• The JSON viewer's path navigation got a visual refresh: updated segment colors, tighter spacing, and tap-to-jump segments. The breadcrumb bar moved to its own file for easier reuse.
• App bar leading icons gained consistent padding and dynamic width so action targets stay tappable across varied layouts.

Fixed

• ISpectSettingsState.toJson() no longer throws when disabled_log_types is non-empty. toMap() now returns a List<String> for that field instead of an unmodifiable Set.

Breaking Changes

• Unified trace() pipeline: All logging now flows through one structured pipeline with consistent correlation across every layer.
• Flattened log data: The old inheritance-based types are gone - typed subclasses (NetworkRequestLog, DioResponseLog, BlocLifecycleLog, …) are replaced by a metadata-driven ISpectLogData, with field accessors like isNetwork and httpStatusCode moved into extensions. See the migration guide below.
• ISpectLogType is now a final class (no longer an enum): ISpectLogType.values becomes ISpectLogType.builtIn and exhaustive switches no longer apply, but custom types are first-class - write const ISpectLogType('my-key', category: 'firebase') directly.
• ISpectLogData.id is now a 26-character ULID instead of a per-isolate int - globally unique, lexicographically sortable, and JSON round-trippable. Equality uses the id alone, which fixes deduplication of persisted history.

Added

• ispect_layout: New standalone visual layout inspector - tap any widget to read its size, constraints, padding, decoration, text styles, transform, and clip shape, or compare two widgets for the pixel gap. Forked from inspector with expanded render-object coverage.
• Plugin architecture for the panel: Lifecycle hooks, custom screens, and action items, with SafePluginScreen and a global ErrorWidget override keeping third-party plugin failures from taking down the host UI.
• Custom ISpectLogType instances with their own category, title, color, and icon, safely merged with the built-in entries.
• Database interceptor cookbook: Drop-in interceptors and runnable examples for Hive, Isar, Drift, Sembast, ObjectBox, Realm, Firestore, Sqflite, SharedPreferences, GetStorage, and FlutterSecureStorage in packages/ispectify_db/example.

Improvements

• New trace API: trace(), traceAsync(), traceSync(), and traceTransaction() for correlated logging, plus domain extensions (authTrace(), storageTrace(), push(), analyticsEvent(), paymentTrace(), grpcTrace()).
• Log exporter: Writes JSON Lines, plain text, Markdown, and CSV with built-in redaction; pluggable formatters give human-readable and JSON Lines output with ISO-8601 timestamps.
• Logs screen overhaul: Resizable desktop split view with keyboard navigation, chip-based search and filtering with category grouping, correlation/transaction-ID filters, expandable network transaction cards with status and duration, live tail with new-log indicators and relative time, 21 new log-type icons, and a JSON viewer with array support and async search.
• Inspector controls: Multi-key shortcuts, initialPanelExpanded, configurable decimalPlaces, smart panel positioning, shape-border and border-radius extraction, and globally-transformed hit testing.
• Picker & zoom bar: A floating Cancel/Confirm bar with zoom controls and a live hex preview chip (tap to copy), on-screen-aware hex placement, auto re-snapshot on surface resize, and the restored outside-stroke disc look.
• consoleMessage parameter on trace, network, WebSocket, and BLoC logs tailors IDE console output without touching structured metadata.
• Lazy ISpect.logger: Constructed on demand, with a developer warning when used before ISpect.run.
• Wider redaction: cURL commands and opt-in clipboard redaction now go through RedactionService, with optional redaction statistics for data and header operations.
• Correlation index: O(1) request/response/error lookup, removing scan-time matching on large histories.
• Database tracing: DbSqlDigest for normalized SQL grouping, DbMessageFormatter for consistent log construction, and new sizeBytes and cacheHit fields.
• Accessibility: Semantic labels on log cards and transactions, 36dp minimum touch targets, and tooltips on app-bar navigation, search, and filter.
• Faster triage: Expanded cards show a one-line metadata strip (id, trace source, operation/target, duration, exception type), and the action-sheet header shows the log type's description.

Behavioral Changes

• Network redaction on by default: All network interceptors redact PII out of the box, using an expanded sensitive-key set.
• ISpectBlocObserver now auto-correlates events, transitions, and changes.
• Auto-wired navigator observer: ISpectNavigatorObserver.observers() publishes the installed observer in ISpectNavigatorObserver.current, and ISpectBuilder.wrap falls back to it - the quick-start no longer needs the same observer shared between MaterialApp.navigatorObservers and ISpectOptions.observer. An explicit ISpectOptions.observer still wins.
• Tips dialog moved from an automatic popup to a dedicated app-bar icon.

Deprecations

• ISpectScopeController.of(context) → use ISpect.read(context). The old method stays as a forwarder and will be removed in 6.0.0.
• Per-callback network filters (requestFilter, responseFilter, errorFilter) on ispectify_dio, ispectify_http, and ispectify_ws → use the new composable filter chain. Existing callbacks keep working as forwarders and will be removed in 6.0.0.
• ISpectBuilder(...) constructor → use ISpectBuilder.wrap(...), which short-circuits before building when kISpectEnabled is false (preserving tree-shaking). The constructor will be made private in a stable 5.x release.
• ISpectLocalizations.delegates(...) → use ISpectLocalizations.delegate(...), which returns only ISpect's delegate and leaves the Global*Localizations to the host. The legacy method works as a forwarder during 5.x and will be removed in 6.0.0.

Bug Fixes

• Async-gap context safety: Fixed "deactivated widget's ancestor" errors in ISpectToaster and clipboard operations by handling BuildContext correctly across async gaps.
• Stability: Resolved memory leaks in UI components and made JSON parsing more robust on large datasets.
• Export hardening: Added CSV-injection protection in exports and a clipboard size cap.
• Inspector hit testing: Now uses Flutter's native pipeline and clamps overlay rects to screen bounds, so taps no longer surface widgets from routes beneath the active one (non-opaque pages, dialogs, modal sheets) or from Offstage / IgnorePointer subtrees, and selection stays on-screen.
• Icon glyph rendering: A RenderParagraph actually showing an icon font now displays the glyph and its U+XXXX code point under an ICON section instead of unreadable tofu.
• Release-safe inspector: describeIdentity and other diagnostic-only formatters were replaced with release-safe equivalents, so the layout inspector no longer throws or leaks debug data in profile and release builds.
• JSON viewer state: JsonScreen.didUpdateWidget compares the data's id, so the viewer no longer rebuilds its tree and discards expansion state when the parent supplies an equal map.

CI/Tests

• Tests & CI: Refactored the suite for the trace-based architecture with JSON and multipart redaction validation, added widget tests (ISpectAppBar, EmptyLogsWidget, LogCard, ISpectBuilder) and BLoC/Dio/HTTP pipeline integration tests, and wired up Codecov with a Flutter version matrix.

Migration Guide

// BEFORE (v4.x): Pattern matching on typed subclasses
if (log is NetworkRequestLog) {
  print(log.method);
  print(log.url);
}

// AFTER (v5.0): Use ISpectLogDataX convenience getters
import 'package:ispectify/ispectify.dart';
if (log.isNetwork) {
  print(log.traceOperation);  // HTTP method
  print(log.traceTarget);     // URL
  print(log.httpStatusCode);  // from traceMeta
}

// NEW: Trace API for custom operations
logger.traceAsync(
  category: authCategory,
  source: 'firebase',
  operation: 'signIn',
  run: () => auth.signIn(email, password),
);

// NEW: Domain extensions
logger.push(source: 'fcm', operation: 'received', messageId: id);
logger.analyticsEvent(source: 'firebase', event: 'purchase');