Added #

• Raw Value Support for Structured Properties
  • Added support for non-compliant vCards with unstructured property values
  • New StructuredName.raw() constructor for creating names from plain strings
  • New StructuredName.fromValue() factory for auto-detecting structured vs raw format
  • New Address.raw() constructor for creating addresses from plain strings
  • New Address.fromValue() factory for auto-detecting structured vs raw format
  • New Organization.raw() constructor for creating organizations from plain strings
  • New Organization.fromValue() factory for auto-detecting structured vs raw format
  • New isRaw and isStructured properties for checking value type
  • New rawValue field for storing unstructured values
  • New toValue() method for serialization (returns raw value if applicable)
  • New toStructured() method for converting raw values to structured format
  • Enhanced copyWith() with clearRaw parameter for converting to structured
  • Improved parsing to handle both structured and unstructured values
  • Updated all formatters (vCard, jCard, xCard) to support raw values

Changed #

• Parser now intelligently detects and handles non-compliant vCards
• Generator preserves raw values when outputting vCards
• Better compatibility with real-world vCard data from various sources

Changed #

• Various improvements and fixes

Changed #

• Add Neo-Brutalism style library logo
• Improve README layout with centered alignment for all header elements

Added #

• Core vCard Support

  • Full support for vCard 2.1, 3.0, and 4.0 specifications
  • RFC 2425 MIME directory framework implementation
  • Line folding/unfolding per RFC specifications
  • Quoted-Printable encoding support for vCard 2.1
  • Value escaping and unescaping

• Alternative Format Support

  • jCard (JSON) format support (RFC 7095)
  • xCard (XML) format support (RFC 6351)
  • Round-trip conversion between formats

• Property Support

  • All essential properties (FN, N, NICKNAME, PHOTO, BDAY, ANNIVERSARY, GENDER)
  • Communication properties (TEL, EMAIL, IMPP, LANG)
  • Address and location (ADR, LABEL, GEO, TZ)
  • Organization properties (ORG, TITLE, ROLE, LOGO, MEMBER, RELATED)
  • Other properties (NOTE, PRODID, REV, SOUND, UID, URL, VERSION, KEY, CATEGORIES, SOURCE, KIND)
  • Extended X- properties support

• API Features

  • Type-safe API with full Dart type system integration
  • Lenient parsing mode for malformed vCards
  • Detailed exception hierarchy for error handling
  • Version detection and automatic parsing
  • Multi-vCard file support

• Platform Support

  • Platform-agnostic implementation (no dart:io dependencies)
  • Works on Web, Mobile (iOS/Android), and Desktop

• Documentation

  • Comprehensive API documentation
  • Usage examples in README
  • RFC reference documentation

Technical Details #

• Pure Dart implementation with zero runtime dependencies
• Extensive unit test coverage
• Follows Dart style guidelines and best practices