fix: update widget properties

example/lib/main.dart

@@ -56,6 +56,9 @@ class HomeScreen extends StatelessWidget {
             onPressed: () {
               print('[HomeScreen.build] Scale pressed');
             },
+            theme: const PressableScaleTheme(
+              scaleFactor: 0.8,
+            ),
             // onLongPressed: () {
             //   print('[HomeScreen.build] Scale long-pressed');
             // },
@@ -65,9 +68,9 @@ class HomeScreen extends StatelessWidget {
             onPressed: () {
               print('[HomeScreen.build] Opacity pressed');
             },
-            theme: PressableOpacityTheme(
+            theme: const PressableOpacityTheme(
               curve: Curves.easeOut,
-              opacityFactor: 0.5,
+              opacityFactor: 0.4,
             ),
             child: const ExampleButton(title: 'Opacity'),
           ),

lib/src/base.dart

@@ -1,5 +1,7 @@
 import 'package:flutter/material.dart';
+import 'package:pressable/pressable.dart';
 
+/// Default [State] for more complex [Pressable] Widgets.
 abstract class PressableBaseState<T extends StatefulWidget> extends State<T> {
   bool isPressed = false;
 

lib/src/builder.dart

@@ -2,11 +2,14 @@ import 'package:flutter/material.dart';
 import 'package:pressable/pressable.dart';
 import 'package:pressable/src/base.dart';
 
+/// Builds [Widget] inside [PressableBuilder].
 typedef PressableBuilderCallback = Widget Function(
   BuildContext context,
   bool isPressed,
 );
 
+/// Use [PressableBuilder] to define your own pressable animation. Simplifies
+/// working with [GestureDetector].
 class PressableBuilder extends Pressable {
   const PressableBuilder({
     Key? key,

lib/src/fill.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 import 'package:pressable/pressable.dart';
 import 'package:pressable/src/base.dart';
 
+/// Fills [child] with selected color when pressed.
 class PressableFill extends Pressable {
   const PressableFill({
     Key? key,

lib/src/opacity.dart

@@ -2,7 +2,7 @@ import 'package:flutter/material.dart';
 import 'package:pressable/pressable.dart';
 import 'package:pressable/src/base.dart';
 
-/// Makes [child] transparent.
+/// Makes [child] semi-transparent when pressed.
 class PressableOpacity extends Pressable {
   const PressableOpacity({
     Key? key,
@@ -24,19 +24,9 @@ class PressableOpacity extends Pressable {
 
 class _PressableOpacityState extends PressableBaseState<PressableOpacity>
     with TickerProviderStateMixin {
-  late final AnimationController _controller = AnimationController(
-    duration: theme.duration,
-    vsync: this,
-    value: 1.0,
-    lowerBound: theme.opacityFactor,
-    upperBound: 1.0,
-  );
-
-  late final Animation<double> _animation = CurvedAnimation(
-    parent: _controller,
-    curve: theme.curve,
-    reverseCurve: theme.reverseCurve,
-  );
+  late AnimationController _controller = _createAnimationController();
+
+  late Animation<double> _animation = _createAnimation();
 
   PressableOpacityTheme get theme {
     return widget.theme ??
@@ -46,6 +36,8 @@ class _PressableOpacityState extends PressableBaseState<PressableOpacity>
 
   @override
   Widget build(BuildContext context) {
+    assert(theme.opacityFactor < 1.0, 'Opacity factor must be less than 1.0');
+
     return GestureDetector(
       onTap: widget.onPressed,
       onTapDown: widget.onPressed != null ? onPressStarted : null,
@@ -101,6 +93,34 @@ class _PressableOpacityState extends PressableBaseState<PressableOpacity>
     _revertAnimation();
   }
 
+  AnimationController _createAnimationController() {
+    return AnimationController(
+      duration: theme.duration,
+      vsync: this,
+      value: 1.0,
+      lowerBound: theme.opacityFactor,
+      upperBound: 1.0,
+    );
+  }
+
+  CurvedAnimation _createAnimation() {
+    return CurvedAnimation(
+      parent: _controller,
+      curve: theme.curve,
+      reverseCurve: theme.reverseCurve,
+    );
+  }
+
+  @override
+  void didUpdateWidget(covariant PressableOpacity oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    if (oldWidget.theme != widget.theme) {
+      _controller.dispose();
+      _controller = _createAnimationController();
+      _animation = _createAnimation();
+    }
+  }
+
   @override
   void dispose() {
     _controller.dispose();

lib/src/platform.dart

@@ -3,6 +3,7 @@ import 'dart:io';
 import 'package:flutter/material.dart';
 import 'package:pressable/pressable.dart';
 
+/// Define default [Pressable] animation for each platform.
 class PressablePlatform extends Pressable {
   const PressablePlatform({
     Key? key,

lib/src/ripple.dart

@@ -1,6 +1,7 @@
 import 'package:flutter/material.dart';
 import 'package:pressable/pressable.dart';
 
+/// Uses default [InkWell] animation.
 class PressableRipple extends Pressable {
   const PressableRipple({
     Key? key,

lib/src/scale.dart

@@ -2,6 +2,7 @@ import 'package:flutter/material.dart';
 import 'package:pressable/pressable.dart';
 import 'package:pressable/src/base.dart';
 
+/// Scales [child] down when pressed.
 class PressableScale extends Pressable {
   const PressableScale({
     Key? key,
@@ -22,19 +23,9 @@ class PressableScale extends Pressable {
 
 class _PressableScaleState extends PressableBaseState<PressableScale>
     with TickerProviderStateMixin {
-  late final AnimationController _controller = AnimationController(
-    duration: theme.duration,
-    vsync: this,
-    value: 1.0,
-    lowerBound: theme.scaleFactor,
-    upperBound: 1.0,
-  );
-
-  late final Animation<double> _animation = CurvedAnimation(
-    parent: _controller,
-    curve: theme.curve,
-    reverseCurve: theme.reverseCurve,
-  );
+  late AnimationController _controller = _createAnimationController();
+
+  late Animation<double> _animation = _createAnimation();
 
   PressableScaleTheme get theme {
     return widget.theme ??
@@ -44,6 +35,8 @@ class _PressableScaleState extends PressableBaseState<PressableScale>
 
   @override
   Widget build(BuildContext context) {
+    assert(theme.scaleFactor < 1.0, 'Scale factor must be less than 1.0');
+
     return GestureDetector(
       onTap: widget.onPressed,
       onTapDown: widget.onPressed != null ? onPressStarted : null,
@@ -103,6 +96,34 @@ class _PressableScaleState extends PressableBaseState<PressableScale>
     _revertAnimation();
   }
 
+  AnimationController _createAnimationController() {
+    return AnimationController(
+      duration: theme.duration,
+      vsync: this,
+      value: 1.0,
+      lowerBound: theme.scaleFactor,
+      upperBound: 1.0,
+    );
+  }
+
+  CurvedAnimation _createAnimation() {
+    return CurvedAnimation(
+      parent: _controller,
+      curve: theme.curve,
+      reverseCurve: theme.reverseCurve,
+    );
+  }
+
+  @override
+  void didUpdateWidget(covariant PressableScale oldWidget) {
+    super.didUpdateWidget(oldWidget);
+    if (oldWidget.theme != widget.theme) {
+      _controller.dispose();
+      _controller = _createAnimationController();
+      _animation = _createAnimation();
+    }
+  }
+
   @override
   void dispose() {
     _controller.dispose();