dataforge_annotation 0.6.0

dataforge_annotation: ^0.6.0 copied to clipboard

Added #

• Comprehensive Documentation: Complete README overhaul for all packages
  • Detailed feature documentation with examples
  • CLI tool usage and performance tips
  • Advanced features guide (custom converters, generics, collections)
  • Comparison table with json_serializable and freezed
  • Migration guides and troubleshooting
  • Chinese README fully synchronized
• Circular Dependency Detection: Automatic detection with clear warnings
• Structured Logging: DataforgeLogger with debug/info/warning/error levels

Fixed #

• DateTime Converter: Fixed dangerous padding logic
  • Correctly handles 10-digit seconds timestamps (Unix standard)
  • Correctly handles 13-digit milliseconds timestamps
  • Throws FormatException for ambiguous lengths
  • Supports ISO 8601 date string parsing
• Type casting for double fields in copyWith (smart casting from int via num)

Changed #

• Updated all code examples with @override annotations (required for mixin pattern)
• Unified analyzer dependency to ^8.1.1 across all packages
• Performance optimizations with @pragma('vm:prefer-inline')

Documentation #

• 25 new tests added (6 for circular dependencies, 19 for DateTime converter)
• README expanded from ~200 lines to 760+ lines with comprehensive guides
• All documentation properly synchronized between English and Chinese versions

Added #

• Circular Dependency Detection: Automatic detection of circular references between Dataforge classes with clear warnings
• Structured Logging: New DataforgeLogger utility with debug/info/warning/error levels
• Comprehensive test coverage: 25 new tests (6 for circular dependencies, 19 for DateTime converter)

Fixed #

• DateTime Converter: Fixed dangerous padding logic that produced incorrect dates
  • Now correctly handles 10-digit seconds timestamps (Unix standard)
  • Now correctly handles 13-digit milliseconds timestamps
  • Throws FormatException for ambiguous timestamp lengths
  • Supports ISO 8601 date string parsing

Changed #

• Unified analyzer dependency to ^8.1.1 across all packages
• Improved error handling with structured logging in dataforge_base

Documentation #

• Added CIRCULAR_DEPENDENCY_ISSUE.md with detailed problem explanation
• Added IMPROVEMENTS_REPORT.md with complete change summary
• Enhanced DateTime converter documentation with examples

• Optimize generated code performance by adding @pragma('vm:prefer-inline').

• Bump version.

• Fix readObject call arguments to pass value directly instead of map and key.

• Refine nested copyWith API: use chained getter syntax (e.g., .$address.street) and remove flat accessor syntax.

• Add readObject and readRequiredObject methods to SafeCasteUtil for parsing nested objects with factory functions.
• Add parseObject method for internal object parsing.
• Rename objectFromJson to use new API pattern.

• Initial development release.