autoverpod

Release of autoverpod package version 0.1.1

Installation

dependencies:
  autoverpod: ^0.1.1

Release of autoverpod_generator package version 0.1.1

Installation

dev_dependencies:
  autoverpod_generator: ^0.1.1

New Features

• NumberField helper - Added NumberField<T extends num> for bidirectional TextEditingController sync with numeric state, including optional parsing/formatting and debounced updates.
• StringField improvements - Added optional debounced updates and emptyAsNull support for nullable String fields.

Release of autoverpod package version 0.1.0

Installation

dependencies:
  autoverpod: ^0.1.0

⚠️ COMPLETE REWRITE - BREAKING CHANGES

This version is a complete rewrite of the autoverpod package. The previous complex form-focused architecture has been replaced with a simpler, more maintainable state widget approach.

Migration Notes

• All previous APIs have been removed - This is not a backwards-compatible update
• Generator changed from build_runner to lean_builder - Run dart run lean_builder instead of dart run build_runner
• Form submission handling removed - Users now handle form submission logic themselves
• Simpler annotation - Use @stateWidget instead of @FormWidget

Why This Change?

The previous version tried to be "too magic" with automatic form handling, mutations, and complex provider generation. This led to:

• High maintenance burden (30+ generator files)
• Difficult to debug generated code
• Tight coupling to specific patterns

The new version is:

• Simpler - Only 5 generator files
• More flexible - Users control form submission
• Easier to maintain - Uses lean_builder for cleaner code generation
• Future-proof - Generates scope widgets even for non-family providers

New Features

• @stateWidget annotation - Simple annotation for generating state field widgets
• Auto text controller sync - StringField helper handles TextEditingController synchronization
• Scope widgets - InheritedWidget-based scoping for family parameters
• Field widgets - Generated field widgets with update methods
• Select widgets - Optimized widgets that only rebuild on selected value changes

What's Generated

For a provider annotated with @stateWidget:

• Field updater extension methods
• Scope widget (for family parameter passing)
• State widget (rebuilds on any state change)
• Select widget (rebuilds on selected value only)
• Individual field widgets with auto text controller sync (for String fields)

Dependencies

• Uses lean_builder instead of build_runner
• Requires flutter_riverpod: >=3.0.0 <4.0.0
• Dart SDK: ^3.6.0

⚠️ COMPLETE REWRITE - BREAKING CHANGES

This version is a complete rewrite of the autoverpod package. The previous form-focused architecture has been replaced with a simpler, more maintainable state widget approach.

Migration Notes

• All previous APIs have been removed – this is not backwards compatible
• @FormWidget and form update APIs have been removed
• New @stateWidget annotation (exported from autoverpod_annotation)
• Form submission handling removed – submission logic is now user-controlled
• Generator moved to lean_builder – use autoverpod_generator ^0.1.0 and run dart run lean_builder instead of build_runner

Why This Change?

The previous version tried to be "too magic" with automatic form handling, mutations, and complex provider generation. This led to:

• High maintenance burden with many generator files
• Difficult-to-debug generated code
• Tight coupling to specific patterns

The new version is:

• Simpler – focused on generating state field widgets
• More flexible – you own submission and side-effect logic
• Easier to maintain – uses lean_builder for cleaner code generation
• Future-proof – generates scope widgets even for non-family providers

New Features

For a provider annotated with @stateWidget and @riverpod, autoverpod now provides:

• Field updater extension methods on the provider notifier
• Scope widget (InheritedWidget) for family parameters
• State widget (*Widget) that rebuilds on any state change
• Select widget (*Select) that rebuilds only on selected value changes
• Individual field widgets with auto TextEditingController sync (for String fields)

Dependencies

• Uses lean_builder instead of build_runner via autoverpod_generator
• Requires flutter_riverpod: >=3.0.0 <4.0.0
• Dart SDK: ^3.6.0

BREAKING CHANGES

• Removed StateWidget annotation - The StateWidget annotation has been removed. Use the new FormWidget annotation instead for form state management.
• Updated Riverpod exports - Replaced StateProvider export with Mutation and MutationTransaction from riverpod/experimental/mutation.dart. This aligns with Riverpod 3.0.3's experimental mutation API.

Features

• New FormWidget annotation - Introducing the @FormWidget annotation for simplified form state management
• Enhanced form validation - Built-in form validation support with automatic error handling
• onStatusChanged callback - Forms now support an onStatusChanged callback to react to form status changes

Migration Guide

From StateWidget to FormWidget

Before (v0.0.5):

@StateWidget()
class CounterForm {
  final int count;
  
  const CounterForm({required this.count});
}

After (v0.0.6):

@FormWidget()
class CounterForm {
  final int count;
  
  const CounterForm({required this.count});
}

From StateProvider to Mutation API

Before (v0.0.5):

import 'package:autoverpod/autoverpod.dart';
// Used StateProvider internally

After (v0.0.6):

import 'package:autoverpod/autoverpod.dart';
// Now exports Mutation and MutationTransaction from riverpod/experimental/mutation.dart

The generated providers are now more powerful and include:

• Form state provider (counterFormProvider)
• Form mutation provider (counterFormMutationProvider)
• Call status provider (counterFormCallStatusProvider)

Upgrade Steps

1. Update dependencies in pubspec.yaml:

   dependencies:
     autoverpod: ^0.0.6
     autoverpod_generator: ^0.0.6
     riverpod: ^3.0.3
   

2. Replace @StateWidget() with @FormWidget() in your code

3. Regenerate code:

   dart run build_runner build --delete-conflicting-outputs
   

4. Update your provider usage to use the new generated providers (form state, mutation, and call status providers)

Requirements

• Dart SDK: ^3.9.2
• Riverpod: ^3.0.3
• Flutter: SDK requirement automatically handled by workspace

• Version bump for release
• Improved stability and bug fixes

• Fix bugs

• Added annotations for form and state widgets
• Improved documentation