zorphy_annotation 2.3.1

Annotations for zorphy code generation package that provides clean class definitions with copyWith, JSON serialization, toString, equality, and inheritance support

2.3.1 - 2026-08-27

Change

• Version synced with zorphy 2.3.1 (no annotation API changes in this release).

2.3.0 - 2026-08-23

Feat

• Added equalityExcludes to @Zorphy, @Zorphy2, and ZorphyX for excluding selected fields from generated equality, lean JSON, and comparison surfaces.
• Added agent annotations: @AgentTool, @AgentRisk, @AgentInternal, @AgentExclude, and @AgentToolParam.
• Added @ZorphyNamedConstructor support for custom constructor bodies.

2.2.0 - 2026-08-21

Change

• Version synced with zorphy 2.2.0 (no annotation API changes in this release).

2.1.1 - 2026-08-21

Change

• Version synced with zorphy 2.1.1 (no annotation API changes in this release).

2.1.0 - 2026-08-03

Feat

• Added MergeMode enum (smart / force) for future per-class merge control — re-exported from zorphy_annotation.dart for consumer access

Change

• SDK constraint aligned to >=3.8.0 <4.0.0 (matches zorphy package)
• Version synced with zorphy 2.1.0

2.0.0 - 2026-08-16

Feat

• @Zorphy(autoId: true) — auto-generated identity: the generated concrete constructor's id parameter is optional and defaults to a fresh Uuid().v4() at construction time (zuraffa#307 — entities like ChatMessage / TelemetryEvent no longer need callers to supply ids). The annotated class declares String get id; and the library imports package:uuid/uuid.dart.
• ZorphyKind (entity / valueObject) on @Zorphy/@Zorphy2 plus the @ZValueObject const alias — marks a class as an immutable composition type with no identity. Codegen (equality, copyWith, JSON) is unchanged; the kind is consumed by the zfa make pipeline to skip root plugins.
• ZorphyX interface extended with kind and autoId getters.

[2.1.0] - 2026-08-03

Feat

• Added MergeMode enum (smart / force) for future per-class merge control — re-exported from zorphy_annotation.dart for consumer access

Change

• SDK constraint aligned to >=3.8.0 <4.0.0 (matches zorphy package)
• Version synced with zorphy 2.1.0

[2.0.0] - 2026-07-30

Break

• All feature flags on @Zorphy/@Zorphy2 are now bool? (default null = inherit from preset). Source-compatible for named-argument use; the resolved semantics are unchanged for defaults
• ZorphyX.generateFilter getter type changed bool → bool?

Feat

• New ZorphyPreset enum (lean / standard / full) and preset parameter on both annotations (default standard, reproducing 1.9.0 output)
• New flags: generateCopyWith, generatePropertyHelpers, generateEqualsToString, generateChangeTo
• @zorphy2/Zorphy2 deprecated — the generator is single-pass since 2.0; the alias behaves identically and will be removed in a later major

1.9.0 - 2026-07-21

Break

• Removed ZorphyJsonHelper and ZorphyJsonCastError classes — no longer used; JSON deserialization is now fully handled by json_serializable's native checked: true generation
• Removed export 'src/json_helper.dart' and export 'src/json_cast_error.dart' from zorphy.dart

1.8.10 - 2026-07-21

Change

• Sync version with zorphy package for consistent release numbering

1.8.9 - 2026-07-21

Change

• Sync version with zorphy package for consistent release numbering

1.8.8 - 2026-07-21

Change

• Sync version with zorphy package for consistent release numbering

1.8.7 - 2026-07-21

Change

• Sync version with zorphy package for consistent release numbering

1.8.6 - 2026-07-20

Change

• Sync version with zorphy package for consistent release numbering

1.8.5 - 2026-07-20

Change

• Sync version with zorphy package for consistent release numbering

1.8.4 - 2026-07-20

Change

• Sync version with zorphy package for consistent release numbering

1.8.3 - 2026-07-20

Change

• Sync version with zorphy package for consistent release numbering

1.8.2 - 2026-07-20

Change

• Sync version with zorphy package for consistent release numbering

1.8.1 - 2026-07-20

Feature

• Added ZorphyJsonCastError and ZorphyJsonHelper classes for shared safe JSON casting with field-level error messages

1.8.0 - 2026-07-20

Change

• Sync version with zorphy package for consistent release numbering

1.7.1 - 2026-05-02

Change

• Release 1.7.1

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

1.6.6 - 2026-04-05

Feature

• Added PatchBase class to centralize JSON serialization for leaner patch generation.

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

Fix

• downgraded annotation dependency to meta 1.17

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.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