camera_scanner_kit 1.1.4

A production-grade Flutter UI toolkit for high-speed POS barcode scanning, featuring native haptics, zero-latency audio, and inline routing.

1.1.4

• Fix: Resolved an async disposal race condition in BarcodeScannerController where notifyListeners() could fire after dispose() if the parent widget was torn down during the UX transition padding delay. The controller now tracks its own disposal state and silently drops stale callbacks.

1.1.3

• Refactor (Lifecycle Management): Migrated BarcodeScannerView lifecycle handling from WidgetsBindingObserver to Flutter's modern AppLifecycleListener API, improving listener disposal and memory safety.
• Feature (Inline Scanner): Added stopCameraOnBackground parameter (defaults to true) to BarcodeScannerView, giving developers granular control over automatic camera hardware teardown when the application transitions to background states.

1.1.2

• UI (Theme Isolation): Refactored internal action buttons to use primitive Material and InkWell widgets, isolating them from legacy global useMaterial3: false theme overrides in host applications.
• UI (Modals): Scoped all modal bottom sheets (like the Scanned Items list) inside a clean Material 3 Theme widget to ensure perfect typography, colors, and border rendering regardless of the parent app's legacy theme matrix.
• Fix: Resolved a runtime Material AssertionError crash caused by conflicting type and shape parameters on circular buttons.

1.1.1

• Fix: Resolved a "zombie stream" deadlock where the barcode EventChannel would silently fail to receive frames after the device was locked and unlocked.
• Fix (ScannerScreen): Implemented a 250ms hardware release delay on AppLifecycleState.resumed to prevent native camera lockups, securely guarded by the _isPopping tripwire.
• UX (Inline Scanner): The BarcodeScannerView now automatically closes its UI and safely detaches from the sensor when the app goes to the background, improving user privacy and preventing battery drain.

1.1.0

• Feature: Added ScannerLensType enum to provide hardware-level control over the physical camera lens. Prevents autofocus "jumping" on iOS Pro models by allowing developers to lock the ultra-wide lens.
• Feature: Exposed the initialZoom parameter across all scanner entry points. Defaulted to null to respect native OS behaviors.
• Refactor: Completely restructured internal package architecture into strict domain folders (inline_scanner, scanner_screen, prebuilt_screens, and widgets).
• Documentation: Added comprehensive, production-grade DartDocs to all public APIs, detailing hardware fragmentation warnings and architecture requirements.

1.0.2

• Feature: Added idempotent start() and stop() methods to BarcodeScannerController for safer programmatic lifecycle control.
• Fix: Resolved a microtask collision and debug-mode breakpoint caused by OS Camera Permission dialogs interrupting the camera boot sequence.
• UI Refactor: Generalized BarcodeScannerView. Replaced hardcoded UI constraints by exposing borderRadius, removing redundant clipping masks, and enforcing compositional padding.
• Polish: Upgraded internal logs to strict enterprise format and improved public API DartDocs.

1.0.1

• Fix pub.dev description length warning to improve search engine SEO and package scoring.

1.0.0

• Initial Stable Release of camera_scanner_kit.
• 9-in-1 Routing Matrix: Modular API providing 9 scanning combinations (Single Scan, Batch accumulation, and real-time Stream routing across Custom, Barcode, and QR Code views).
• POS Mode: Dedicated PosBarcodeScannerScreen featuring built-in quantity adjustment controls (+/-), success/error haptic feedback, and a reactive badge showing scanned item summaries in a sheet.
• Inline Mode: Embeddable, inline BarcodeScannerView with smooth collapsible window blind animations, flashlight toggles, and automatic teardown on inactivity timeout.
• Teardown & Lifecycle Protection: Hardware-safe tripwire system to prevent deactivated-widget crashes, ghost scans, and camera locks across Android and iOS lifecycle transitions.

0.0.0

• Internal Alpha Release.
• Extracted core scanning logic into a modular package architecture.
• Implemented 9-in-1 routing matrix (Single, Batch, Stream, etc.).
• Added PosBarcodeScannerScreen with quantity increment/decrement controls.
• Standardized UI components (Overlays, Connected Toolbars, Error Widgets).
• Prepended library logs with [CameraScannerKit] for easier debugging.