qr_scanner_kit 0.3.0

A ready-to-use QR scanner screen and viewfinder overlay built on mobile_scanner, with torch, camera switching, and a simple scan callback.

0.3.0 - 2026-11-03

• Add continuous scanning: QrScanner(continuous: true) keeps the camera running and reports every accepted code instead of stopping after the first.
• Add duplicateWindow (default two seconds) and the public ScanDeduper, which suppress repeated captures of the same code in continuous mode.
• Add hint and hintStyle to draw a short instruction over the preview.
• Add scanWindow to restrict detection to a rectangle of the preview.
• Add errorBuilder and a default camera error view with a retry button. A denied camera permission gets a dedicated message.
• popOnScan applies to the one-shot mode; continuous mode never pops.

0.2.0 - 2026-10-14

• Add barcode format selection: QrScanner passes formats to the internally created controller. An injected controller keeps its own formats.
• Add gallery scanning: QrImageScanner.scanImageFile decodes one barcode from an image file with its own short-lived controller. A live camera scan stays untouched. Unsupported platforms throw an UnsupportedError.
• Add haptics: hapticsEnabled (default true) plays a light haptic impact when the scanner accepts a code.
• Add validation hooks: isAccepted filters values before the one-shot gate. A rejected value consumes no scan attempt, fires no haptics, and calls onRejected instead of onScan.

0.1.2

• Documentation and internal cleanup.

0.1.1

• Rewrite the README. The install section now uses flutter pub add qr_scanner_kit.

0.1.0

• Initial release.
• Extracted the Rocketbot app's QR scanning into a reusable package: QrScanner, BarcodeOverlay, and ScanGate, built on mobile_scanner ^7.
• QrScanner is a full-screen scanner with a camera preview, torch control, and front/back camera switching.
• Every capture goes through a single scan-result path (one barcode stream subscription), fixing the app's old widget that handled results twice through both onDetect and a stream listener.
• Lifecycle-safe disposal ordering: the widget stops the subscription, then disposes the controller, and the controller is never disposed from the scan handler. Camera stop errors are swallowed instead of surfacing as unhandled exceptions.
• BarcodeOverlay.scale now preserves every configured value (border, radius, cut-out, and offset) instead of resetting them to defaults.
• onScan has one-shot semantics: at most one value per widget lifetime. popOnScan: false keeps the screen open but reports no further barcodes.
• An injected MobileScannerController has its autoStart setting respected; the widget still manages start/stop and takes ownership by disposing it.
• BarcodeOverlay is derived from OverlayShape in ai_barcode_scanner 5.2.2 (Apache-2.0); attribution is documented in the README and THIRD_PARTY_NOTICES.