🔧 Update Pack 2 #14

Author: SaadArdati

example/lib/stories/text_animation.dart

@@ -5,6 +5,7 @@ import 'package:flutter/scheduler.dart';
 import 'package:google_fonts/google_fonts.dart';
 import 'package:hyper_effects/hyper_effects.dart';
 import 'package:smooth_page_indicator/smooth_page_indicator.dart';
+import 'package:unicode_emojis/unicode_emojis.dart';
 
 class TextAnimation extends StatefulWidget {
   const TextAnimation({super.key});
@@ -78,6 +79,18 @@ class IPhone extends StatelessWidget {
   }
 }
 
+final String _allEmojis =
+    UnicodeEmojis.allEmojis.map((emoji) => emoji.emoji).join('');
+
+class EmojiTapeBuilder extends CharacterTapeBuilder {
+  @override
+  String get characters => _allEmojis;
+
+  @override
+  bool compare(String a, String b) =>
+      _allEmojis.contains(a) && _allEmojis.contains(b);
+}
+
 class EmojiLine extends StatefulWidget {
   const EmojiLine({super.key});
 
@@ -111,7 +124,10 @@ class _EmojiLineState extends State<EmojiLine> {
           ),
         )
             .roll(
-              tapeStrategy: const ConsistentSymbolTapeStrategy(4),
+              tapeStrategy:
+                  ConsistentSymbolTapeStrategy(4, characterTapeBuilders: {
+                EmojiTapeBuilder(),
+              }),
               tapeSlideDirection: TextTapeSlideDirection.alternating,
               staggerTapes: true,
               tapeCurve: Curves.easeInOutBack,
@@ -395,7 +411,9 @@ class _LikeButtonState extends State<LikeButton> {
                         .copyWith(color: Colors.white, fontSize: 16),
                   )
                       .roll(
-                        tapeStrategy: const AllSymbolsTapeStrategy(false),
+                        tapeStrategy: const AllSymbolsTapeStrategy(
+                          repeatCharacters: false,
+                        ),
                         symbolDistanceMultiplier: 2,
                         clipBehavior: Clip.none,
                         tapeCurve: Curves.easeOutQuart,
@@ -452,8 +470,8 @@ class _LikeButtonState extends State<LikeButton> {
                         .copyWith(color: Colors.white, fontSize: 16),
                   )
                       .roll(
-                        tapeStrategy:
-                            const ConsistentSymbolTapeStrategy(0, true),
+                        tapeStrategy: const ConsistentSymbolTapeStrategy(0,
+                            repeatCharacters: true),
                         symbolDistanceMultiplier: 2,
                         clipBehavior: Clip.none,
                         tapeCurve:
@@ -505,8 +523,8 @@ class _LikeButtonState extends State<LikeButton> {
                         .copyWith(color: Colors.white, fontSize: 16),
                   )
                       .roll(
-                        tapeStrategy:
-                            const ConsistentSymbolTapeStrategy(0, false),
+                        tapeStrategy: const ConsistentSymbolTapeStrategy(0,
+                            repeatCharacters: false),
                         symbolDistanceMultiplier: 2,
                         clipBehavior: Clip.none,
                         tapeCurve: Curves.easeOutBack,

example/pubspec.yaml

@@ -15,6 +15,7 @@ dependencies:
   hyper_effects:
     path: ../
   google_fonts: ^6.2.1
+  unicode_emojis: ^0.4.0
   smooth_page_indicator: ^1.1.0
 
 dev_dependencies:

lib/src/effects/roll/symbol_tape_strategy.dart

@@ -1,16 +1,13 @@
 import 'dart:math';
 
 import 'package:flutter/widgets.dart';
-import 'package:unicode_emojis/unicode_emojis.dart';
 
 const String _kLowerAlphabet = 'abcdefghijklmnopqrstuvwxyz ';
 const String _kUpperAlphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
 const String _kNumbers = '0123456789';
 const String _kSymbols = '`~!@#\$%^&*()-_=+[{]}\\|;:\'",<.>/?';
 const String _kSpace = ' ';
 const String _kZeroWidth = '​';
-final String _allEmojis =
-    UnicodeEmojis.allEmojis.map((emoji) => emoji.emoji).join('');
 
 extension _StringHelper on String {
   bool isSymbol() => _kSymbols.contains(this);
@@ -24,8 +21,18 @@ extension _StringHelper on String {
   bool isLowerAlphabet() => _kLowerAlphabet.contains(this);
 
   bool isUpperAlphabet() => _kUpperAlphabet.contains(this);
+}
+
+/// A builder that constructs a tape of characters tailored for a specific
+/// condition of characters such as emojis.
+abstract class CharacterTapeBuilder {
+  /// The characters that are used to build the tape of characters. For example,
+  /// an entire emoji set.
+  String get characters;
 
-  bool isEmoji() => _allEmojis.contains(this);
+  /// Compares two strings to determine if the builder should be used to
+  /// insert the [characters] into the main tape.
+  bool compare(String a, String b);
 }
 
 /// Defines the strategy to create the tape of character symbols
@@ -38,9 +45,17 @@ sealed class SymbolTapeStrategy {
   ///     be rendered and animated to roll twice instead of just once.
   final bool repeatCharacters;
 
+  /// A set of [CharacterTapeBuilder]s that can be used to build the tape
+  /// of characters to interpolate to and from for a specific set of characters,
+  /// like emojis.
+  final Set<CharacterTapeBuilder> characterTapeBuilders;
+
   /// Creates a new [SymbolTapeStrategy] with the given [repeatCharacters]
   /// property.
-  const SymbolTapeStrategy([this.repeatCharacters = true]);
+  const SymbolTapeStrategy({
+    this.repeatCharacters = true,
+    this.characterTapeBuilders = const {},
+  });
 
   /// Builds the tape of characters to interpolate to and from.
   String build(String a, String b) =>
@@ -68,8 +83,10 @@ sealed class SymbolTapeStrategy {
       if (a.isNumber() || b.isNumber()) {
         charKitBuffer.write(_kNumbers);
       }
-      if (a.isEmoji() || b.isEmoji()) {
-        charKitBuffer.write(_allEmojis);
+      for (final CharacterTapeBuilder builder in characterTapeBuilders) {
+        if (builder.compare(a, b)) {
+          charKitBuffer.write(builder.characters);
+        }
       }
     }
 
@@ -107,8 +124,10 @@ sealed class SymbolTapeStrategy {
       if (a.isNumber() || b.isNumber()) {
         charKitBuffer.write(_kNumbers);
       }
-      if (a.isEmoji() || b.isEmoji()) {
-        charKitBuffer.write(_allEmojis);
+      for (final CharacterTapeBuilder builder in characterTapeBuilders) {
+        if (builder.compare(a, b)) {
+          charKitBuffer.write(builder.characters);
+        }
       }
     }
 
@@ -137,7 +156,7 @@ sealed class SymbolTapeStrategy {
 class AllSymbolsTapeStrategy extends SymbolTapeStrategy {
   /// Creates a new [AllSymbolsTapeStrategy] with the given [repeatCharacters]
   /// property.
-  const AllSymbolsTapeStrategy([super.repeatCharacters = true]);
+  const AllSymbolsTapeStrategy({super.repeatCharacters = true});
 }
 
 /// Constructs symbol tapes that contain all the characters
@@ -167,9 +186,11 @@ class ConsistentSymbolTapeStrategy extends SymbolTapeStrategy {
 
   /// Creates a new [ConsistentSymbolTapeStrategy] with the given [distance]
   /// and [repeatCharacters] properties.
-  const ConsistentSymbolTapeStrategy(this.distance,
-      [super.repeatCharacters = true])
-      : assert(
+  const ConsistentSymbolTapeStrategy(
+    this.distance, {
+    super.repeatCharacters = true,
+    Set<CharacterTapeBuilder> characterTapeBuilders = const {},
+  }) : assert(
           distance >= 0,
           'Distance must be >= 0.',
         );

pubspec.yaml

@@ -19,7 +19,6 @@ dependencies:
   flutter:
     sdk: flutter
   equatable: ^2.0.5
-  unicode_emojis: ^0.4.0
   collection: ^1.18.0
 
 dev_dependencies: