zorphy 1.9.0

A powerful code generation package for Dart/Flutter that provides clean class definitions with copyWith, JSON serialization, toString, equality, and inheritance support

1.9.0 - 2026-07-21

Breaking

• Replaced inline _zc/ZorphyJsonHelper safe-cast approach with native json_serializable deserialization using checked: true — field-level error messages are now provided by CheckedFromJsonException from the json_serializable package rather than custom ZorphyJsonCastError
• Removed zorphy_annotation source files: json_helper.dart and json_cast_error.dart — these are no longer needed; all JSON deserialization is handled by json_serializable directly

Fix

• Map<K, V> fields (e.g. Map<String, String>?, Map<String, Entity>?) now correctly deserialize because checked: true + native generation produces recursive .map((k, e) => MapEntry(k, e as String)) conversions in the .g.dart file, resolving runtime type '_Map<String, dynamic>' is not a subtype of type 'Map<String, String>' errors

Chore

• Upgraded build_runner to ^2.15.2, source_gen to ^4.2.3, json_annotation to ^4.12.0
• Removed dependency_overrides for analyzer and meta — packages now resolve coherently against the SDK

Features preserved from earlier releases (cherry-picked)

• Refined nullable-string property helpers: text?.isNotEmpty == true instead of text != null && text.isNotEmpty
• Const constructor support for non-sealed abstract classes

1.8.10 - 2026-07-21

Fix

• Replaced deprecated @JsonKey(ignore: true) with @JsonKey(includeToJson: false, includeFromJson: false) on hashCode getter
• Map<K,V> fields now use direct (json['f'] as Map<K,V>?) cast instead of ZorphyJsonHelper.cast to avoid runtime type erasure issues (e.g. Map<String, dynamic> vs Map<String, String>)

1.8.9 - 2026-07-21

Fix

• Replaced deprecated @JsonKey(ignore: true) with @JsonKey(includeToJson: false, includeFromJson: false) on hashCode getter

1.8.8 - 2026-07-21

Fix

• hashCode getter is now annotated with @JsonKey(ignore: true) to prevent json_serializable from including it in toJson output (regression from createFactory: false changes)

1.8.7 - 2026-07-21

Fix

• List<Object> and other identity-cast list fields now cast directly to the target type (as List<Object>?) instead of going through List<dynamic> which isn't assignable in Dart 3
• Fields like List<Object>? get match now generate (json['match'] as List<Object>?)

1.8.6 - 2026-07-20

Fix

• Reverted List/Set field casts from ZorphyJsonHelper.cast<List<dynamic>> back to (json['f'] as List<dynamic>) — generic function return types don't satisfy Dart 3's type system for downstream typed list parameters
• Enum detection now scans analyzer-level type arguments, catching enums that only appear inside generic types like List<TransformationType> without a bare TransformationType field

1.8.5 - 2026-07-20

Fix

• List<EnumType> fields in fromJson now use $enumDecode(_$EnumTypeEnumMap, e) for element conversion instead of incorrectly calling EnumType.fromJson(e as Map<String, dynamic>)

1.8.4 - 2026-07-20

Fix

• Fields with @JsonKey(fromJson: someConverter) but no includeFromJson: false now correctly call the converter instead of falling through to .fromJson() on the raw type

1.8.3 - 2026-07-20

Fix

• Non-sealed abstract classes with const constructors now correctly generate const ClassName(); instead of ClassName();

1.8.2 - 2026-07-20

Refactor

• Simplified nullable string property helpers: hasText now uses text?.isNotEmpty == true instead of text != null && text.isNotEmpty

Chore

• Removed CI-based pub.dev publishing; publish script now publishes directly via dart pub publish --force

1.8.1 - 2026-07-20

Fix

• Replaced per-class _zc<T>() static helpers with shared ZorphyJsonHelper.cast<T>() from zorphy_annotation for Dart 3.12+ compatibility
• Added ZorphyJsonCastError with field-level context in error messages

1.8.0 - 2026-07-20

Feature

• Safe fromJson casts with field-level error messages — replaces json_serializable delegates with inline _zc<T>() wrapper that throws TypeError.withStackTrace including field name, expected type, actual type, and the value itself
• Example error: Zorphy: Field 'id' expected String, got int (42)

1.7.1 - 2026-05-02

Change

• updated dependencies

1.7.0 - 2026-04-30

Change

• Upgrade to analyzer 13 and update dependencies

1.6.9 - 2026-04-27

Change

• Revert property helper generation to ownFields and fix automated publishing flow

1.6.8 - 2026-04-27

Change

• Streamline release process and fix PropertyHelpers extension generation for inherited fields

1.6.7 - 2026-04-06

Fix

• Factory method parameter types now preserve import prefixes (as clauses) in generated code

1.6.6 - 2026-04-05

Feature

• Extracted Patch class boilerplate into PatchBase to drastically reduce generated code size.
• Fixed toJson() bug on abstract base classes in explicit subtypes changeTo extension.

1.6.5 - 2026-04-01

Change

• Analyzer 12 compabilities

1.6.4 - 2026-02-15

Fix

• Have to upgrade Analyzer package due to bug in 10.0.0

1.6.3 - 2026-02-15

1.6.2 - 2026-02-15

Fix

• works with analyzer 10.0.0 that dont require meta 1.18

1.6.1 - 2026-02-15

Change

• Refactored CLI code to be more robust and consumable

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.

1.6.0 - 2026-02-14

Change

• Update Zorphy CLI to be more extensible and consumable by other CLIs

1.5.8 - 2026-02-14

Fix

• Nonsealed classes with explicit subtypes can have their own fromJson

1.5.7 - 2026-02-14

Fix

• Modified skip logic in getProperties() to not skip fields that exist in both parentFields and ownFields (overridden fields)
• Prevents duplicate @override annotation when source already has it
• Constructor generation isParentField check now excludes fields in ownFields so overridden fields use this.field syntax
• Added _getCovariantFields() helper to detect fields where class type differs from interface type
• getInterfaceCopyWithMethods() now uses class field types (not interface types) for parameters and adds covariant where needed
• getInterfaceCopyWithFnMethods() now uses class field types for parameters

1.5.6 - 2026-02-14

Chore

• Updated docs and created docusaurus website
• Create public constructors by default and only create private when hidden

1.5.5 - 2026-02-13

Fix

• Fixed null type issue on custom toJson

1.5.4 - 2026-02-13

Change

• Allow hybrid serialization with json_serializable for generic field types

1.5.3 - 2026-02-13

Fix

• Fixed JsonKey and other annotations not being caught due to Analyzer 10 changes

1.5.2 - 2026-02-12

Fix

• Updated copyWith generation to use a sentinel parameter pattern, preserving non-nullable fields while allowing explicit nulls for nullable fields

1.5.1 - 2026-02-11

Fix

• Fixed issue with nested entity

1.5.0 - 2026-02-09

Feat

• Added property helpers extension

1.4.1 - 2026-02-09

Chore

• Bumped example versions

1.4.0 - 2026-02-07

Feat

• Added [feature description needed]

1.3.4 - 2026-02-07

Fix

• Referencing issues

1.3.3 - 2026-02-07

Fix

• Upgraded dependencies

1.3.2 - 2026-02-06

Fix

• Analyzer compatibility improvements

1.3.1 - 2026-02-06

Fix

• Improved type handling

1.3.0 - 2026-02-06

Changed

• Updated to new Zorphy API

1.2.1 - 2026-02-05

Chore

• Updated test dependency

1.2.0 - 2026-02-05

Chore

• Downgraded analyzer version to match latest Flutter SDK

1.1.1 - 2026-02-05

Fix

• Fixed copyWith method name generation

1.1.0 - 2026-02-05

Change

• Fixed edge case where a class extends a sealed class and implements another class causing parameters not passed in super constructor

1.0.0 - 2026-02-04

Added

• Initial release of zorphy_annotation package
• Core @Zorphy() annotation with full configuration support
• generateJson option for JSON serialization
• generateCompareTo option for diff generation
• generateCopyWithFn option for function-based copyWith
• explicitSubTypes option for sealed class hierarchies
• Support for generic type parameters
• Support for nested object patching
• Support for self-referencing types
• Support for multiple inheritance via interfaces
• Support for enum fields
• Support for constant constructors
• Full TypeScript-style type safety

Features

• Immutable data class generation
• Automatic constructor generation
• Smart copyWith methods
• Advanced patching system with fluent API
• JSON serialization with lean JSON option
• Sealed classes with polymorphic serialization
• Multiple inheritance support
• Generic class support
• Enum integration
• Self-referencing type support
• Comparison and diff generation
• Equality and hashCode generation
• ToString generation
• Type-safe field enums

Documentation

• Comprehensive README with examples
• Quick start guide
• Feature reference
• Real-world usage examples