built_value_generator

• Reduce use of dynamic calls in generated operator== when there are functions: only use dynamic calls if the class also has type parameters.

• Require analyzer ^10.0.0, stop using removed and deprecated methods from earlier versions.

• Allow analyzer 10.0.0.

• Allow analyzer 9.0.0.

• Enable build_runner 2.7.0 "triggers" optimization.
• built_value will now only run in libraries that directly import package:built_value/built_value.dart or use an annotation called @SerializersFor. Other files will be quickly skipped and show in build_runner output as "not triggered" or "skipped".
• If you need to run built_value on other source files, see https://pub.dev/packages/build_config#triggers for how to configure your own additional triggers for built_value.

• Require analyzer ^8.0.0.
• Allow built_value_generator to use build 4.0.0.
• Allow built_value_generator to use source_gen 4.0.0.

• Allow built_value_generator to use analyzer 8.0.0.

• Use build ^3.0.0.
• Use source_gen ^3.0.0.

• Use build ^3.0.0-dev.
• Use source_gen ^3.0.0-dev.

• Add mutable collection serializers so built_value can serialize List, Set and Map. It's still recommended to avoid mutable collections inside value types as they break hashing, comparison and caching; the intended use case is that you have one top level mutable collection of your immutable value types.

• Stop generating unnecessary new keywords.
• Stop generating explicit null checks in constructors: these are not needed with sound null safety.
• Stop generating checks for dynamic in generics in constructors: accidental use of dynamic is better avoided with lints than a runtime check.

• Allow built_value_generator to use analyzer 7.0.0.

• Allow built_value_generator to use source_gen 2.0.0.

• Generate code that formats faster with current "short" style. Both versions are fast with the coming "tall" style.
• Mark @nullable deprecated: it does nothing and should not be used.

• Improve build performance when there are lots of built_value classes.

• Fix for new warning about operator== param type.

• In StandardJsonPlugin, add support for specifying types that should be left as List.
• Allow non alphanumeric characters in EnumClass names.

• Fix codegen for enum wire keys when there is a $ in the field name.
• Remove support for generating legacy (<2.12) Dart code.

• Allow classes with record fields to be serialized if they use a typedef for the record type and install a custom Serializer for it.

• Add Int32 serializer.

• Bump version of analyzer.

• Remove JSON from DeserializationError message to prevent data accidentally leaking into logs. The JSON is still available on the DeserializationError object.
• Fix generation for fields that are Function types that are declared separately, for example in a mixin defined in another source file, and use named or positional parameters.

• Fix support for generating enum mixins for Dart 3. Instead of triggering mixin generation with abstract class TestEnumMixin = Object with _$TestEnumMixin it must now be triggered with typedef TestEnumMixin = _$TestEnumMixin.

• Add support for value types with record fields. Serialization with records is not yet supported.
• Fix generator failure due to top level record field.
• Migrate benchmark and examples to null safety.
• Remove pre-null-safe test cases.
• Remove analyzer plugin.
• Remove reference to @nullable annotation from failure-to-instantiate message.

• Add Uint8ListSerializer.
• Generate Dart-3-compatible code if needed.
• Stop using deprecated analyzer API.
• Fix codegen for optional fields with $ in the name.

• Increase minimum version of analyzer.
• Fix generation with the type Never.

• Fix generated deserialization code when there is a manually written builder with nullable fields.
• Drop dev dependency on quiver.
• Disable all linting of generated code.
• Change generated hash code implementation so it formats better when there are many fields.

• Prepare for breaking analyzer changes.
• Bump version of analyzer.

• Bump version of analyzer.

• Fix custom builders in null safe code: allow nested builder fields to be nullable.
• Improve custom builders for null safe code: allow abstract setter/getter pairs instead of fields. This allows nested builders to have a setter that accepts null and a getter that guarantees not to return null, which is what auto instantiation of nested builders already provides.
• Allow use of super field initialization in EnumClass.

• Fix erroneously generated null check for fields with generic bounds.

• Migrate built_value_test to null safety.

• Fix generation support for optional generic bounds, e.g. class Foo<T extends Object?>.
• Fix generation for classes with names starting $.
• Ignore lint unnecessary_lambdas in generated code.

• Change generated build methods to return only public types, creating _build methods that return the generated impl types. This means dartdoc will no longer reference the generated types.
• Ignore the no_leading_underscores_for_local_identifiers lint in generated code.
• Migrated built_value_generator to null safety. This is purely an internal change, the generator can still generate legacy code as and when needed.

• Bug fix: fix a corner case with generics that had incorrect serializer generation.

• Bug fix: remove a print from the enum generator.

• Fix deps: allow built_value_generator to use built_value 8.2.0.

• Allow writing final parameters in EnumClass constructor and valueOf method.
• Make generator output additional explicit null checks so the generated code complies with the cast_nullable_to_non_nullable lint.
• Bump version of analyzer.

• Bump version of analyzer.

• Bump version of analyzer, fix deprecation warnings.

• Bump version of analyzer.

• Bug fix: allow constructors to have annotations. Previously, annotations would cause codegen to fail.

New features:

• Add @BuiltValueHook annotation. It provides the same functionality as _initializeBuilder and _finalizeBuilder, but in a more visible way: annotate a static method on the value class with @BuiltValueHook to have it called on builder creation or finalization.
• Add back serializeNulls to BuiltValueSerializer annotation. By default generated serializers skip null fields instead of writing them; set serializeNulls to write the nulls.

New minor functionality:

• Support use of nulls in collections when the key or value types are explicitly nullable.
• Allow JsonObject to be instantiated from a Map<dynamic, dynamic>.
• Mark nested builder getters in instantiable: false classes not nullable, to match the implementations. Use autoCreateNestedBuilders: false to get the old behaviour.
• Allow explicit nulls in JSON for nullable fields when deserializing.
• Specify annotation targets; the analyzer will now hint if a built_value annotation is used where it has no effect.
• Support polymorphism with mixed in parent value type: generated builder now mixes in parent builder.

Bug fixes:

• Fix support for serializing and deserializing nulls.
• Fix nestedBuilders: false with instantiable: false.
• Fix enum deserialization fallback for int.
• Annotating a wrong type getter with @SerializersFor is now an error, instead of just generating nothing.

Cleanup:

• Removed Angular mixin from example, as this feature is no longer needed: Angular now directly supports using static members in templates.

• Bump versions of build_config and build_runner.

• Bump version of analyzer.

• Bump version of source_gen.

• Fix error message for builder factory not installed.
• Bump version of build.

• Bump versions of analyzer, quiver.

• Update chat example to webdev.
• Allow nulls when serializing/deserializing for better JSON interop.
• Fix generation bugs around enum wire name and polymorphism.
• Fix generation with generics for analysis with strict-raw-types.
• Add test coverage around generation for generic serialization.
• Add test coverage around initialization with generics.

• Stable null safe release.
• Add toJson and fromJson convenience methods to Serializers.

• Migrate to NNBD.
• Remove dependency on package:quiver.
• Remove support for serializing nulls using BuiltValueSerializer(serializeNulls: true).
• Make installed plugins public in Serializers as serializerPlugins.
• @memoized fields can now memoize null; previously, nulls would not be cached, causing the computation to rerun.

• Support analyzer ^0.40.0.
• Workaround https://github.com/google/built_value.dart/issues/941.

• Support private Built classes. Note that private classes cannot be made serializable.
• Support serializing enums to ints: add wireNumber to @BuiltValueEnumConst.
• Support memoizing hashCode, so it's computed lazily once. Write an abstract getter int get hashCode; then annotate it with @memoized to turn this on for a built_value class.
• Trim built_value_test dependencies: depend on matcher instead of test.
• Fix enum generator error messages when value and valueOf are missing.

• Fix unescaped string usages while generating ValueSourceClass.
• Fix analyzer use: don't rely on toString on types.

• Fix analyzer lower bound: was 0.39.0, needs to be 0.39.3.

• Fix regression in a corner case when determining which fields to generate based on mixins.
• Tweak generation changes for implicit-casts: false and implicit-dynamic: false. Relax casts again where possible.