rdf_mapper_annotations 0.2.1

Dart annotations for declarative RDF graph mapping and code generation.

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.

[0.2.1] - 2025-06-25

Added

• Comprehensive enum support: Added @RdfEnumValue annotation for customizing individual enum constant serialization values
• Enhanced @RdfLiteral for enums: Extended @RdfLiteral annotation to support direct application to enums with automatic mapper generation
• Enhanced @RdfIri for enums: Extended @RdfIri annotation to support enum mapping with IRI templates and {value} placeholder substitution
• Property-level enum overrides: Enum properties can now use all existing property-level mapping options (custom mappers, language tags, datatypes)
• Validation and documentation: Added comprehensive validation rules, error handling documentation, and best practices for enum mapping
• Examples and guides: Added example/enum_mapping_simple.dart and doc/enum_mapping_guide.md with complete usage examples

Enhanced

• Improved documentation: Updated main library documentation with enum usage examples and integration patterns
• Extended property mappings: Enhanced LiteralMapping and IriMapping classes with enum-specific documentation and examples

[0.2.0] - 2025-06-20

Changed

• BREAKING: Updated dependency to rdf_mapper ^0.8.0 and adjusted to breaking API changes in the underlying mapper library
• BREAKING: Fixed design issues in @RdfLiteral.custom() constructor - methods now work with LiteralTerm instead of String so that they can me used for any LiteralTerm (de-)serialization (including language tags).
• Updated IRI template semantics to support {+variable} syntax for context variables that may contain URI-reserved characters (prevents percent-encoding)
• Improved documentation for IRI template variables and context variable handling

Fixed

• Corrected parameter order and nullability in @RdfLiteral.custom() constructor
• Updated examples to work with the new rdf_mapper 0.8.0 API

[0.1.0] - 2025-05-23

Added

• Initial Release - Added all annotations and some examples
• Comprehensive documentation for all annotation classes
• Quick start example in README.md