feat!: modernize library to v2.0.0

* feat!: modernize library to v2.0.0 with breaking API cleanup

- BREAKING: onChanged signature changed from Function({bool changed})
  to ValueChanged<bool> for idiomatic Flutter usage
- Bump flutter_svg ^2.0.7 -> ^2.2.3, mocktail ^0.3.0 -> ^1.0.4,
  flutter_lints ^2.0.0 -> ^6.0.0
- Raise SDK floor: Flutter >=3.27.0, Dart >=3.4.0
- Fix: add super.key, const Colors, private state fields,
  remove double-animation flash in initState, move onChanged
  call outside setState
- Replace empty test suite with 11 widget tests
- Add min_coverage: 70 to CI workflow

https://claude.ai/code/session_01TR448dBnMeBSf6cHZfpCD2

* docs: update README for v2.0.0 breaking API change

- Update install version to ^2.0.0
- Fix onChanged signature in basic and advanced examples
- Add migration guide for v1.x -> v2.0.0

https://claude.ai/code/session_01TR448dBnMeBSf6cHZfpCD2

* docs: remove migration guide and breaking change notes

No active users — no need for backward compat messaging.

https://claude.ai/code/session_01TR448dBnMeBSf6cHZfpCD2

* fix: add Yako to cspell allowlist

https://claude.ai/code/session_01TR448dBnMeBSf6cHZfpCD2

* ci: add automated pub.dev publish workflow on version tags

Uses OIDC (no secrets required). Triggers on tags matching v*.*.*.

https://claude.ai/code/session_01TR448dBnMeBSf6cHZfpCD2

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: yadaniyil

.github/cspell.json

@@ -16,6 +16,7 @@
   ],
   "useGitignore": true,
   "words": [
-    "yako_theme_switch"
+    "yako_theme_switch",
+    "Yako"
   ]
 }

.github/workflows/main.yaml

@@ -23,3 +23,4 @@ jobs:
     uses: VeryGoodOpenSource/very_good_workflows/.github/workflows/flutter_package.yml@v1
     with:
       flutter_channel: stable
+      min_coverage: 70

.github/workflows/publish.yaml

@@ -0,0 +1,12 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+
+jobs:
+  publish:
+    permissions:
+      id-token: write # Required for OIDC publishing to pub.dev
+    uses: dart-lang/setup-dart/.github/workflows/publish.yml@v1

CHANGELOG.md

@@ -1,2 +1,26 @@
+## [2.0.0] - [Apr 9, 2026]
+
+### Improvements
+* Added `super.key` to constructor — widgets can now be identified by key.
+* State class fields are now private (`_animationController`, `_turnState`, etc.).
+* `createState` uses `State<YakoThemeSwitch>` return type annotation.
+* `const Color(...)` used for default color literals.
+* Removed redundant `addPostFrameCallback` animation trigger in `initState` — eliminates a visual flash on initial render.
+* `onChanged` callback is now called outside `setState`, following Flutter best practices.
+* Replaced bare `Container` with `SizedBox` for the toggle hit area (semantic clarity).
+
+### Dependency Updates
+* `flutter_svg` bumped from `^2.0.7` to `^2.2.3`
+* `mocktail` bumped from `^0.3.0` to `^1.0.4`
+* `flutter_lints` bumped from `^2.0.0` to `^6.0.0`
+* Minimum Flutter SDK raised from `>=3.10.0` to `>=3.27.0`
+* Minimum Dart SDK raised from `>=3.0.0` to `>=3.4.0`
+
+### Tests
+* Replaced empty/commented test suite with 11 widget tests covering:
+  rendering, default state, enabled state, tap callbacks, external prop
+  updates, custom width, custom colors, custom duration, border radius,
+  key support, and multi-tap alternation.
+
 ## [1.0.0+1] - [Jul 9, 2023]
 * First release

README.md

@@ -11,22 +11,26 @@ Just a cool switch for your app's theme
 In your pubspec.yaml
 ```yaml
 dependencies:
-  yako_theme_switch: ^1.0.0
+  yako_theme_switch: ^2.0.0
 ```
 <br>
 
 ## Basic Usage:
 ```dart
     YakoThemeSwitch(
       enabled: themeMode == ThemeMode.light,
-      onChanged: ({bool? changed}) {},
+      onChanged: (bool value) {
+        setState(() => themeMode = value ? ThemeMode.light : ThemeMode.dark);
+      },
     );
 ```
 ## Advanced usage
 ```dart
     YakoThemeSwitch(
       enabled: themeMode == ThemeMode.light,
-      onChanged: ({bool? changed}) {},
+      onChanged: (bool value) {
+        setState(() => themeMode = value ? ThemeMode.light : ThemeMode.dark);
+      },
       width: 50,
       enabledBackgroundColor: Colors.blue,
       disabledBackgroundColor: Colors.red,

lib/src/yako_theme_switch.dart

@@ -8,8 +8,8 @@ class YakoThemeSwitch extends StatefulWidget {
   /// You can set the custom width of the switch
   final double width;
 
-  /// Just a callback function to get the changed state of the switch
-  final Function({bool changed}) onChanged;
+  /// Callback invoked with the new state whenever the switch is toggled
+  final ValueChanged<bool> onChanged;
 
   /// The background color of the switch when it is enabled
   final Color? enabledBackgroundColor;
@@ -26,10 +26,11 @@ class YakoThemeSwitch extends StatefulWidget {
   /// The duration of the animation
   final Duration animationDuration;
 
-  /// The border radius of the toggle. Try setting it to 4 and chech how circle now is square
+  /// The border radius of the toggle. Try setting it to 4 to make the circle square
   final double? enabledToggleBorderRadius;
 
   const YakoThemeSwitch({
+    super.key,
     this.enabled = false,
     this.width = 45,
     this.enabledBackgroundColor,
@@ -42,61 +43,57 @@ class YakoThemeSwitch extends StatefulWidget {
   });
 
   @override
-  _YakoThemeSwitchState createState() => _YakoThemeSwitchState();
+  State<YakoThemeSwitch> createState() => _YakoThemeSwitchState();
 }
 
 class _YakoThemeSwitchState extends State<YakoThemeSwitch>
     with SingleTickerProviderStateMixin {
-  late AnimationController animationController;
-  late Animation<double> animation;
-  late bool turnState;
-  late Color enabledBackgroundColor;
-  late Color disabledBackgroundColor;
-  late Color enabledToggleColor;
-  late Color disabledToggleColor;
-  double animationControllerValue = 0.0;
+  late AnimationController _animationController;
+  late Animation<double> _animation;
+  late bool _turnState;
+  late Color _enabledBackgroundColor;
+  late Color _disabledBackgroundColor;
+  late Color _enabledToggleColor;
+  late Color _disabledToggleColor;
+  double _animationValue = 0.0;
 
   @override
   void dispose() {
-    animationController.dispose();
+    _animationController.dispose();
     super.dispose();
   }
 
   @override
   void initState() {
     super.initState();
 
-    enabledBackgroundColor =
+    _enabledBackgroundColor =
         widget.enabledBackgroundColor ?? Colors.grey.shade300;
-    disabledBackgroundColor =
-        widget.disabledBackgroundColor ?? Color(0xFF2E386E);
-    enabledToggleColor =
+    _disabledBackgroundColor =
+        widget.disabledBackgroundColor ?? const Color(0xFF2E386E);
+    _enabledToggleColor =
         widget.enabledToggleColor ?? Colors.amberAccent.shade700;
-    disabledToggleColor = widget.disabledToggleColor ?? Color(0xFF70E2FB);
+    _disabledToggleColor =
+        widget.disabledToggleColor ?? const Color(0xFF70E2FB);
 
-    animationControllerValue = widget.enabled ? 1.0 : 0.0;
-    animationController = AnimationController(
-      value: animationControllerValue,
+    _turnState = widget.enabled;
+    _animationValue = widget.enabled ? 1.0 : 0.0;
+
+    _animationController = AnimationController(
+      value: _animationValue,
       vsync: this,
       lowerBound: 0.0,
       upperBound: 1.0,
       duration: widget.animationDuration,
     );
-    animation =
-        CurvedAnimation(parent: animationController, curve: Curves.easeInOut);
-
-    animationController.addListener(() {
-      setState(() {
-        animationControllerValue = animation.value;
-      });
-    });
-    turnState = widget.enabled;
+    _animation = CurvedAnimation(
+      parent: _animationController,
+      curve: Curves.easeInOut,
+    );
 
-    WidgetsBinding.instance.addPostFrameCallback((_) {
+    _animationController.addListener(() {
       setState(() {
-        if (turnState) {
-          animationController.forward();
-        }
+        _animationValue = _animation.value;
       });
     });
   }
@@ -105,29 +102,26 @@ class _YakoThemeSwitchState extends State<YakoThemeSwitch>
   void didUpdateWidget(YakoThemeSwitch oldWidget) {
     super.didUpdateWidget(oldWidget);
 
-    // if enabled value is updated, reflect the change in switch
     if (oldWidget.enabled != widget.enabled) {
-      turnState = widget.enabled;
-      if (turnState) {
-        animationController.forward();
+      _turnState = widget.enabled;
+      if (_turnState) {
+        _animationController.forward();
       } else {
-        animationController.reverse();
+        _animationController.reverse();
       }
     }
   }
 
   @override
   Widget build(BuildContext context) {
     final Color? transitionColor = Color.lerp(
-      disabledBackgroundColor,
-      enabledBackgroundColor,
-      animationControllerValue,
+      _disabledBackgroundColor,
+      _enabledBackgroundColor,
+      _animationValue,
     );
 
     return GestureDetector(
-      onTap: () {
-        toggle(changeState: true);
-      },
+      onTap: _toggle,
       child: Container(
         padding: const EdgeInsets.all(3),
         width: widget.width,
@@ -138,23 +132,21 @@ class _YakoThemeSwitchState extends State<YakoThemeSwitch>
         child: Stack(
           children: <Widget>[
             Transform.translate(
-              offset: Offset((widget.width - 25) * animationControllerValue, 0),
+              offset: Offset((widget.width - 25) * _animationValue, 0),
               child: Transform.rotate(
-                angle: animationControllerValue,
-                child: Container(
+                angle: _animationValue,
+                child: SizedBox(
                   height: 18,
                   width: 18,
-                  alignment: Alignment.center,
                   child: Stack(
                     children: <Widget>[
                       Center(
                         child: Opacity(
-                          opacity:
-                              (1 - animationControllerValue).clamp(0.0, 1.0),
+                          opacity: (1 - _animationValue).clamp(0.0, 1.0),
                           child: SvgPicture.asset(
                             'assets/dark_mode_switch_icon.svg',
                             colorFilter: ColorFilter.mode(
-                              disabledToggleColor,
+                              _disabledToggleColor,
                               BlendMode.srcIn,
                             ),
                             height: 18,
@@ -164,12 +156,13 @@ class _YakoThemeSwitchState extends State<YakoThemeSwitch>
                       ),
                       Center(
                         child: Opacity(
-                          opacity: animationControllerValue.clamp(0.0, 1.0),
+                          opacity: _animationValue.clamp(0.0, 1.0),
                           child: Container(
                             decoration: BoxDecoration(
                               borderRadius: BorderRadius.circular(
-                                  widget.enabledToggleBorderRadius ?? 20),
-                              color: enabledToggleColor,
+                                widget.enabledToggleBorderRadius ?? 20,
+                              ),
+                              color: _enabledToggleColor,
                             ),
                           ),
                         ),
@@ -178,19 +171,22 @@ class _YakoThemeSwitchState extends State<YakoThemeSwitch>
                   ),
                 ),
               ),
-            )
+            ),
           ],
         ),
       ),
     );
   }
 
-  void toggle({bool changeState = false}) {
+  void _toggle() {
     setState(() {
-      if (changeState) turnState = !turnState;
-      turnState ? animationController.forward() : animationController.reverse();
-
-      widget.onChanged(changed: turnState);
+      _turnState = !_turnState;
+      if (_turnState) {
+        _animationController.forward();
+      } else {
+        _animationController.reverse();
+      }
     });
+    widget.onChanged(_turnState);
   }
 }

pubspec.yaml

@@ -1,6 +1,6 @@
 name: yako_theme_switch
 description: Custom switch that looks good for changing the theme of the app
-version: 1.0.0+1
+version: 2.0.0
 repository: https://github.com/yako-dev/flutter-yako-theme-switch
 issue_tracker: https://github.com/yako-dev/flutter-yako-theme-switch/issues
 
@@ -12,19 +12,19 @@ screenshots:
     path: assets/showcase_animation.gif
 
 environment:
-  sdk: ">=3.0.0 <4.0.0"
-  flutter: ">=3.10.0"
+  sdk: ">=3.4.0 <4.0.0"
+  flutter: ">=3.27.0"
 
 dependencies:
   flutter:
     sdk: flutter
-  flutter_svg: ^2.0.7
+  flutter_svg: ^2.2.3
 
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  mocktail: ^0.3.0
-  flutter_lints: ^2.0.0
+  mocktail: ^1.0.4
+  flutter_lints: ^6.0.0
 
 flutter:
   assets: