flutter_ocr_identity_extractor 1.2.0

A Flutter package for extracting text from images and parsing Saudi ID card data using Google ML Kit Text Recognition. Supports OCR operations and comprehensive ID card data extraction.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.2.0 - 2025-12-15

Added

• Smart Name Handling: Automatic transliteration to ensure both Arabic and English names are always available
  • If only Arabic name is found, automatically transliterates to English
  • If only English name is found, automatically transliterates to Arabic
  • Ensures 100% name coverage in both languages
• Comprehensive Gender Detection: Multiple strategies for accurate gender identification
  • Enhanced text-based detection supporting Arabic (ذكر/أنثى) and English (Male/Female, M/F)
  • Name-based detection from "بن" (male) or "بنت" (female)
  • Image-based gender detection using Google ML Kit Face Detection and Image Labeling
  • ImageGenderAnalyzer service for analyzing ID card photos
  • EnhancedIdExtractor combining all detection methods for maximum accuracy
• Better pattern matching for gender keywords with support for labels (الجنس:, النوع:, Sex:, Gender:)

Improved

• Enhanced SaudiIdParser.parseOcrText() to automatically provide both name translations
• Enhanced AiIdExtractor.extractWithAi() with smart name transliteration
• More robust gender extraction with multiple fallback strategies
• Better logging for debugging name and gender detection

Technical

• Added ImageGenderAnalyzer service using ML Kit Face Detection and Image Labeling
• Added EnhancedIdExtractor for comprehensive ID extraction with all features
• Improved Arabic transliteration utilities
• Added _transliterateArabicToEnglish() method to SaudiIdParser

1.0.0 - 2025-01-10

Added

• Initial release of Flutter OCR Identity Extractor
• OCR text extraction using Google ML Kit Text Recognition
• Support for multiple recognition scripts (Latin, Arabic, etc.)
• Comprehensive Saudi ID card data extraction with parsing
• AI-powered extraction with confidence scoring
• Arabic name transliteration support
• Arabic-Indic and Persian digits conversion
• Hijri to Gregorian date conversion
• Support for File, file path, and image bytes input
• Singleton pattern for efficient resource management

Features

• OcrService - Main OCR service for text extraction from images
• SaudiIdParser - Parser for extracting Saudi ID card data from OCR text
• AiIdExtractor - AI-powered extractor with confidence scoring for ID card fields
• SaudiIdData - Data model for extracted ID card information
• ArabicTransliterator - Utility for Arabic-English name transliteration
• Support for citizen, resident, and visitor ID card types
• Automatic gender detection from identity number
• Date parsing and validation
• Place of birth extraction