Added #

• Layout-aware parsers for YAML, Markdown, XML, and JSON with metadata extraction
• Layout generators for YAML and Markdown that preserve original formatting
• LayoutAwareParseResult model for returning both data and key-level metadata
• KeyMetadata model for storing per-key layout information
• Format-specific metadata models: YamlMeta, MarkdownMeta, XmlMeta, JsonMeta
• preserveLayout parameter to all format conversion functions for round-trip fidelity
• Support for YAML anchors, aliases, comments, and scalar styles preservation
• Support for XML attributes, CDATA, namespaces, and comments preservation
• Support for Markdown header levels, list styles, and formatting preservation

Changed #

• Format converter functions now properly extract and pass keyMeta from LayoutAwareParseResult
• Conversion functions pass preserveLayout through to output generators instead of forcing false
• Improved documentation for preserveLayout parameter behavior

Technical Details #

• Layout parsers extract metadata during parsing without modifying data structure
• Layout generators use metadata to reconstruct original formatting
• Enables byte-for-byte round-trip fidelity when converting between formats
• Backward compatible: preserveLayout defaults to false for parsing, true for generation

Added #

• TurboSerializableConfig class for configuring serialization callbacks
• Export of TurboSerializableConfig from main library for easier imports
• Case converter utility (convertCase) for flexible string casing transformations
• Case style support for serialization in TurboSerializable with CaseStyle enum
• TurboConstants class for centralized constant management
• Enhanced markdownToYaml function with metaData, includeNulls, and prettyPrint parameters
• Enhanced serialization methods with includeNulls and prettyPrint options
• Comprehensive architectural documentation and specifications
• Expanded testing guidelines and documentation structure

Changed #

• Refactored TurboSerializable to use TurboSerializableConfig for serialization method configuration
• Standardized callback names in TurboSerializableConfig:
  • toJsonCallback → toJson
  • toYamlString → toYaml
  • toMarkdownString → toMarkdown
• Primary format is now automatically determined from provided callbacks (priority: json > yaml > markdown > xml)
• Updated toXml method to include includeMetaData parameter
• Renamed mapToXml to jsonToXml for consistency in XML conversion

Fixed #

• Function naming consistency in XML converter (mapToXml → jsonToXml)

Technical Details #

• Introduced HasToJson interface for metadata types that can be serialized to JSON
• Removed deprecated toJsonImpl methods in favor of callback-based implementations
• Enhanced documentation to guide users on the new configuration setup
• Ensured backward compatibility with existing serialization methods where applicable

Changed #

• Rewrote README with Library/Package format: badges, features list, API reference tables, focused examples
• Reduced README from 329 to 90 lines (73% reduction)

Added #

• Standalone format converter functions: jsonToYaml, jsonToMarkdown, jsonToXml, yamlToJson, yamlToMarkdown, yamlToXml, markdownToJson, markdownToYaml, markdownToXml, xmlToJson, xmlToYaml, xmlToMarkdown
• jsonToXml and xmlToMap functions for direct JSON/XML conversion
• Markdown-to-JSON parsing with YAML frontmatter support
• JSON-to-Markdown conversion with header-based format (keys become ##, ###, ####, **bold** at level 5+)
• Title Case conversion for markdown headers
• PascalCase option for XML element names
• Metadata support for all format conversions
• Comprehensive integration test suite with 284 tests
• Edge case sample files covering: deep nesting, unicode/emoji, empty collections, YAML anchors/aliases, XML declarations, and format-specific features

Changed #

• Removed deprecated from* instance methods (use standalone converter functions instead)

Fixed #

• XML converter uses XmlText.value instead of deprecated XmlData.text

Added #

• Initial release
• TurboSerializable<M> abstract class with optional serialization methods and typed metadata support
• TurboSerializableId<T, M> with typed identifier and metadata support
• Optional metaData field for frontmatter and auxiliary data
• Supported formats: JSON, YAML, Markdown, XML