phonic 1.1.2

phonic: ^1.1.2 copied to clipboard

Fixed #

• Fixed bug where corrupted text data from legacy containers (especially ID3v1) was being displayed as strange characters
• Enhanced merge policy to automatically filter out corrupted text tags containing excessive null bytes or non-printable characters
• Album and other text fields now properly return null instead of displaying corrupted data
• Improved data quality by preventing corrupted metadata from reaching the user

Fixed #

• Fixed bug where year tags were not being derived from dateRecorded fields when explicit year tags were missing
• Added automatic tag inference integration to derive missing metadata tags from available data
• Year tags are now automatically derived with TagConfidence.derived provenance when only dateRecorded is present
• AlbumArtist tags are now automatically inferred with TagConfidence.inferred provenance when only artist is present

Added #

• JSON serialization support for all metadata tags with provenance preservation
• Individual toJson() and fromJson() methods for each metadata tag type
• Centralized provenance conversion in TagProvenance class

Added #

• Initial release of Phonic audio metadata library
• Support for MP3 files with ID3v1, ID3v2.2, ID3v2.3, and ID3v2.4 tags
• Support for FLAC files with Vorbis Comments
• Support for OGG Vorbis files with Vorbis Comments
• Support for Opus files with Vorbis Comments
• Support for MP4/M4A files with iTunes-compatible atoms
• Unified API for reading and writing metadata across all supported formats
• Automatic format detection and capability handling
• 50+ metadata tag types including title, artist, album, genre, artwork, and more
• Multi-valued tag support (genres, artists, composers)
• Lazy loading artwork system with memory optimization
• Advanced artwork handling with multiple types (front cover, back cover, artist photo, etc.)
• Streaming operations for batch processing large collections
• Memory-efficient processing with automatic resource management
• Tag provenance tracking to identify metadata sources
• Cross-format metadata conversion with intelligent mapping
• Comprehensive validation system with format-specific constraints
• Error handling with typed exceptions
• Unknown data preservation during tag operations
• Performance optimization utilities (string interning, caching)
• Progress tracking and cancellation support for long operations
• Collection analysis tools for music library management
• 145 comprehensive test files covering all formats and edge cases
• Complete documentation with guides and examples
• 7 example files demonstrating common usage patterns

Dependencies #

• convert: ^3.1.2
• equatable: ^2.0.7
• collection: ^1.18.0