mix_generator 2.2.0

A code generator for Mix, an expressive way to effortlessly build design systems in Flutter.

2.2.0

Stable release of the 2.2.0 line. Cumulative since 2.1.3:

• FEAT: Generate @MixWidget(target:) wrappers for plain Widget constructors without requiring StyleWidget or extension call() methods. Preserve target generics, key/default forwarding, enum variant constructors, independent widget/factory parameter curation, and clean same-build generated Styler support.
• FEAT: Emit a complete $stylerFieldNames inventory for generated Stylers so schema tooling can validate field coverage directly from runtime classes. stylerFieldNames is now reserved, with a targeted diagnostic, and generated field-name literals safely escape $ identifiers. Generated output requires Mix 2.2.0 or newer.
• FEAT: Forward canonical named factories and matching fluent anchors from nested StyleSpec<XSpec> fields with @MixableField(forwardStyler: true). A source-Spec stylerSurface override supports compatible restricted surfaces without resolving same-package generated Stylers, with field-located diagnostics for invalid or ambiguous configurations (#983).
• FIX: Accept visible typedefs in generated library scope whose expansion names hidden types (#1058).
• FIX: Drop redundant this qualifiers from generated @MixWidget build methods. The unused build parameter is now the wildcard BuildContext _, so a field named context still forwards the widget's own value instead of the build context. The values forwarded to the target constructor or factory are unchanged.
• FIX: Preserve type parameters and bounds from uninstantiated generic targets in generated @MixableSpec(target:) call() methods, and reject instantiated or aliased generic targets instead of silently widening them in @MixableSpec(target:) or @MixWidget(target:). Reject a target type parameter named Key when it would shadow the generated Flutter key parameter (#1023).
• FIX: Allow @MixableSpec(target:) to use plain Widget constructors whose named style parameter accepts the generated Styler, without requiring the target to extend StyleWidget (#1022).
• FIX: Generate @MixWidget wrappers on clean builds when a factory returns a Styler generated by a same-library @MixableSpec (#995).
• FIX: Render forwarded nested Styler APIs in the host library scope, delegate restricted aliases through the actual nested implementation, validate custom forwarding setterType construction and method compatibility, and reject collisions with inherited MixStyler members.

2.2.0-beta.4

• FIX: Drop redundant this qualifiers from generated @MixWidget build methods. The unused build parameter is now the wildcard BuildContext _, so a field named context still forwards the widget's own value instead of the build context. The values forwarded to the target constructor or factory are unchanged.

2.2.0-beta.3

• FEAT: Emit a complete $stylerFieldNames inventory for generated Stylers so schema tooling can validate field coverage directly from runtime classes. stylerFieldNames is now reserved, with a targeted diagnostic, and generated field-name literals safely escape $ identifiers. Generated output requires Mix 2.2.0-beta.5 or newer.
• FIX: Preserve type parameters and bounds from uninstantiated generic targets in generated @MixableSpec(target:) call() methods, and reject instantiated or aliased generic targets instead of silently widening them in @MixableSpec(target:) or @MixWidget(target:). Reject a target type parameter named Key when it would shadow the generated Flutter key parameter (#1023).
• FIX: Allow @MixableSpec(target:) to use plain Widget constructors whose named style parameter accepts the generated Styler, without requiring the target to extend StyleWidget (#1022).

2.2.0-beta.2

• FEAT: Generate @MixWidget(target:) wrappers for plain Widget constructors without requiring StyleWidget or extension call() methods. Preserve target generics, key/default forwarding, enum variant constructors, independent widget/factory parameter curation, and clean same-build generated Styler support.

2.2.0-beta.1

• FIX: Generate @MixWidget wrappers on clean builds when a factory returns a Styler generated by a same-library @MixableSpec. The generator now derives the call surface from the spec's target: constructor while preserving widget-parameter curation, key forwarding, enum variants, and unmatched-type diagnostics (#995).

2.2.0-beta.0

• FEAT: Forward canonical named factories and matching fluent anchors from nested StyleSpec<XSpec> fields with @MixableField(forwardStyler: true). A source-Spec stylerSurface override supports compatible restricted surfaces without resolving same-package generated Stylers, with field-located diagnostics for invalid or ambiguous configurations (#983).
• FIX: Render forwarded nested Styler APIs in the host library scope, delegate restricted aliases through the actual nested implementation, validate custom forwarding setterType construction and method compatibility, and reject collisions with inherited MixStyler members.

2.1.3

• FEAT: Support @MixWidget(widgetParameters: .only({...})) for a stable, curated generated widget value-parameter API. Factory parameters, valid Key? key forwarding, and method-level type parameters remain automatic; excluded optional parameters use the styler method's defaults and are not validated for generated-widget visibility or name collisions. Annotations from older mix_annotations releases retain .all() behavior.

2.1.2

• FEAT: Generate one named widget constructor per accessible enum value when an @MixWidget function has a named, non-nullable enum parameter named variant (for example, Button.solid(...)). The existing unnamed constructor remains unchanged.
• FEAT: Derive nested styler types for StyleSpec<XSpec> spec fields by the XSpec -> XStyler naming convention. Generated spec stylers now expose styler-typed constructors, setters, and field factories with Prop.maybeMix merge semantics for nested specs without requiring @MixableField(setterType:) — including same-package generated stylers, which annotation type arguments can never resolve during generation. setterType still overrides the convention. Breaking for specs that relied on nested StyleSpec constructor params being raw resolved values: pass the corresponding styler instead.
• FIX: Allow @MixWidget to generate widgets from generic styler call<T>() methods, preserving type parameter bounds and forwarding type arguments to the styler call.

2.1.1

• FEAT: Support @MixableField(setterType:) on @MixableModifier fields. Generated ModifierMix constructors accept the declared Mix type and wrap values with Prop.maybeMix (#950).
• FEAT: Support @MixableField(setterType:) on @MixableSpec fields. Generated spec stylers expose Mix-typed setters and field factories for nested StyleSpec fields (#951).

2.1.0

• FEAT: Add @MixableModifier generator. Annotate a WidgetModifier subclass to generate its modifier mixin and ModifierMix class. Requires mix_annotations ^2.1.0 (#924).
• FEAT: Generate spec stylers with parity coverage, emitting styler methods that match the spec's resolvable surface (#923).
• TEST: Cover the single-field debugFillProperties cascade in generated output (#942).
• FEAT: Add @MixWidget generator. Annotate a top-level final styler variable or a styler-returning function; the generator emits a StatelessWidget whose build() delegates to that styler's call(). Constructor parameters mirror the styler's call() signature, with Key? key forwarded via super.key.
• CHORE: Match Flutter's canonical Key type via TypeChecker instead of comparing parameter type names. The styler call() may declare exactly Key? key (named, nullable, no default, not required) to opt into super.key forwarding. Any other key-named parameter — subclasses such as LocalKey? / GlobalKey?, non-nullable Key, positional, defaulted, or a key parameter on the factory function — is rejected with an InvalidGenerationSource error.
• CHORE: Generated build() now forwards every constructor field as this.<name> so user parameter names cannot be shadowed by build()'s local context or by the factory reference. Parameter names matching the factory identifier or inherited StatelessWidget / Widget / Object members (build, createElement, runtimeType, hashCode, toString, noSuchMethod) are now rejected with InvalidGenerationSource.
• CHORE: @MixWidget(name: '...') overrides are validated as Dart class identifiers; non-identifier shapes and Dart reserved words are rejected.
• CHORE: The annotated library must import package:flutter/widgets.dart without a prefix. Prefixed Flutter imports are rejected with a clear error pointing to the unprefixed import (or a barrel re-export).
• CHORE: @MixWidget requires the annotated element's name to be lowerCamelCase ending in Style. Names that don't match are rejected; use @MixWidget(name: '...') to override.
• FEAT: Emit a @Deprecated typedef _$<Name>SpecMethods = _$<Name>; alongside every @MixableSpec mixin so legacy class X extends Spec<X> with Diagnosticable, _$XSpecMethods declarations keep compiling against the 2.0+ generator. Removal scheduled for mix_generator 3.0.
• CHANGED: Under the legacy declaration shape, toString() now routes through Diagnosticable.toDiagnosticsNode, replacing Equatable's X(field: …) format with Flutter's diagnostic-node format. Update any tests that pinned the old string.
• CHORE: Drop unused direct dependencies (collection, build_config, logging, path); the generator no longer references them.
• FIX: GeneratedSpecMethods.skipEquals now only suppresses props generation. The rest of the equality surface (==, hashCode, getDiff, stringify) is always emitted, preserving the supported "user authors props" flag semantic after the spec-shape refactor.
• FIX: Prop<T> detection now uses a URL-based TypeChecker (package:mix/src/core/prop.dart#Prop) instead of matching on the simple name Prop. Prevents unrelated local classes named Prop from being mistaken for Mix's Prop.
• FIX: @Mixable validation now requires the annotated class to extend Mix<T> (or a subclass) directly. Classes extending Mixable<T> without going through Mix<T> are rejected with a clear error — the generated mixin's on Mix<T> constraint would have failed at apply time anyway.
• TEST: Consolidate generator test helpers (partBuilder, styleStub, mixElementStub, propStub, mixAnnotationsSources) into test/core/test_helpers.dart. Adds regression tests for skipEquals, fake-Prop<T> rejection, and Mixable<T>-direct-subclass rejection.

2.0.1

• REFACTOR: Tighten field-model validation and shared type-helper extraction across mix/styler generators (#895).
• TEST: Add generator smoke and validation integration tests plus broader builder coverage (#895).

2.0.0

• Stable release matching the 2.0.0-rc.1 surface, with READMEs refreshed for the 2.0 generator API (#887, #888).

2.0.0-rc.1

• BREAKING: The Mix Generator was completely rebuilt to support the architecture and requirements of Mix V2.0.
• FEAT: Support Style class extensions in code generation (#845).
• FEAT: Add MixableSpec, MixableStyler, and code generation for properties (#835).
• FIX: Respect nullability in lerp resolver.
• FIX: Make copyWith parameters nullable (#848).

1.7.0

• REFACTOR: Rename WidgetModifiersData to WidgetModifiersConfig (#649).
• REFACTOR: Fix deprecations and modernize codebase (#647).
• FIX: update animated property handling to use null coalescing (#637).
• FEAT: Add generated style-focused modifiers and specs (#652).
• FEAT: unify SpecUtility, Style, and Attributes as compatible values (#643).
• FEAT: builder optimization (#629).

0.4.0

• REFACTOR: Rename MixableProperty to MixableType (#574)
• REFACTOR: mix generator clean up and mix semantic changes (#569)
• CHORE: Update min version compatibility (#572)

0.3.2

• REFACTOR: Rewrite Fortaleza theme using the new code gen for tokens (#528).
• FIX: Shadow list animation (#445).
• FEAT: Create code gen for design tokens (#521).
• FEAT: Rewrite FlexBox as a Mix's primitive component (#517).
• FEAT: Fluent API (#475).
• FEAT: Remix improvements and further improvements (#410).
• DOCS: improve mix theme data features explanations (#404).

0.3.1

• FEAT: Fluent API (#475).

0.3.0

• FIX: SpecModifiers were taking a long time to animate. (#457).
• FIX: Shadow list animation (#445).

0.2.2+1

• DOCS: improve mix theme data features explanations (#404).

0.2.2

• FEAT: Code generation for Widget Modifiers (#396).
• FEAT: Dto utility generation now adds constructor and static methods (#377).
• FEAT: ColorSwatchToken and other token improvements (#378).
• REFACTOR: Code gen more lint friendly dart code (#399) and (#395).
• FIX: Nullable merge expressions and updates debug properties (#392).

0.2.1

• REFACTOR: bump flutter version to 3.19.0 (#365).
• FEAT: modifiers in spec (#333).

0.2.0

• Fixed: issue with getting correct type override from MixableDto
• Improved: Dto resolved type look up logic
• Added: generation List of value extension of a Dto
• Added: Class and Enum utility generation

0.1.2

• Fixed: Resolved conflict on generators when not configured on build.yaml

0.1.1

• Added: Support for Spec Attributes

0.1.0

• Initial release.