document_camera_frame 2.1.0

document_camera_frame: ^2.1.0 copied to clipboard

added:

• On-device OCR (text extraction): Optional text recognition via enableExtractText.
• enableExtractText parameter: When true, runs OCR after capture and sets DocumentCaptureData.frontOcrText and backOcrText before calling the save callback (no API key or internet required).
• OcrService class: Reusable on-device OCR using Google ML Kit (Latin script; English and other Latin-based languages). Exported from the package for custom use.
• DocumentCaptureData.frontOcrText and DocumentCaptureData.backOcrText: Optional extracted text when enableExtractText is true.
• Dependency: google_mlkit_text_recognition for OCR.

changed:

• onDocumentSaved: New preferred callback name (replaces onBothSidesSaved). Fits both one-sided documents (e.g. passport) and two-sided (e.g. ID). Callback receives DocumentCaptureData with image paths and, when enableExtractText is true, frontOcrText and backOcrText.
• onBothSidesSaved is deprecated; use onDocumentSaved. The deprecated callback still works for backward compatibility.
• DocumentCaptureData model: Now holds optional frontOcrText and backOcrText; doc comment updated for one-sided vs two-sided use.

notes:

• OCR supports Latin script only (English, etc.). Arabic is not supported by ML Kit's on-device model.
• Android: minSdk 21+ required. iOS: platform 15.5+ and armv7 exclusion recommended for ML Kit.

• Update Readme.md
• Update metadata

added:

• Modular styling system with dedicated style classes:
  • DocumentCameraAnimationStyle
  • DocumentCameraFrameStyle
  • DocumentCameraButtonStyle
  • DocumentCameraTitleStyle
  • DocumentCameraSideIndicatorStyle
  • DocumentCameraProgressStyle
  • DocumentCameraInstructionStyle
• Auto-capture functionality via enableAutoCapture parameter.
• Error handling with onCameraError callback.
• Enhanced animation using FrameCaptureAnimation.
• Performance boost using ValueListenableBuilder with child.
• Complete Dart documentation for all style properties.

changed:

• BREAKING: Replaced individual style params with grouped style objects.
• BREAKING: Constructor now uses style classes (buttonStyle, animationStyle, etc.).
• Optimized animation rendering and reduced rebuilds.
• Refactored code for better structure and performance.

migration_guide: before: |

DocumentCameraFrame(
  captureButtonStyle: buttonStyle,
  captureButtonAlignment: Alignment.center,
  captureButtonPadding: EdgeInsets.all(16),
  capturingAnimationDuration: Duration(seconds: 1),
)

after: |

  DocumentCameraFrame(
  buttonStyle: DocumentCameraButtonStyle(
  captureButtonStyle: buttonStyle,
  captureButtonAlignment: Alignment.center,
  captureButtonPadding: EdgeInsets.all(16),
  ),
  animationStyle: DocumentCameraAnimationStyle(
  capturingAnimationDuration: Duration(seconds: 1),
  ),
)

• Update examples.gif
• Update Readme.md
• Update metadata

• Update metadata

• Update metadata

added:

• Two-sided document capture: front and back.
• Callbacks: onFrontCaptured, onBackCaptured, onBothSidesSaved.
• Custom titles and instructions per side.
• Navigation controls and side indicator UI.
• Animated progress bar and frame flip transitions.
• Camera switching via button.

changed:

• BREAKING: Replaced onSaved with onBothSidesSaved.
• Refactored to support two-sided logic and flow.
• Enhanced transitions and layout handling.

fixed:

• Better capture reset flow.
• Improved multi-side state handling.
• Camera-related error recovery.

• Update metadata.

features:

• Added camera switch icon. fixes:
• retakeButtonText and saveButtonText now display correctly.
• Custom camera selection (not hardcoded to ID 0).

• Update Readme.md.

• Update metadata.

• Added showCloseButton flag.
• Frame animation duration reduced to 400ms.

• Redesigned DocumentCameraFrame UI.
• Added:
  • captureOuterCircleRadius
  • captureInnerCircleRadius
• Smooth container open animation (bottom to top).
• Documentation updated accordingly.

• Add example.gif
• Update Readme.md.

• Add example.mp4
• Update Readme.md.

• README and metadata updates.

• Fixed deprecated usage in DocumentCameraFramePainter:
  • Changed Colors.black.withOpacity(0.5) to Colors.black.withAlpha(127).

• Initial release.