story_maker 1.2.0

story_maker: ^1.2.0 copied to clipboard

• First release version.

• Improved the quality of the edited image.

• Fixed aspect ratio issues.

• Fixed widgets positions for small devices.

• Updated libraries.
• Fixed some bugs.

• Updated Dart and Pub dependencies.
• Improved code documentation.
• Fixed various bugs and issues.
• Optimized code for better performance.
• Updated example app.

Major Features Added #

• Stickers Support: Added comprehensive sticker functionality with emoji and image/GIF support

  • Support for emoji stickers (default set of 50+ emojis)
  • Support for custom image/GIF stickers via StickerItem class
  • Customizable sticker list via customStickers parameter
  • Sticker selector widget with horizontal scrolling interface

• Color Filters: Added 8 color filter options for image enhancement

  • Sepia, Grayscale, Vintage, Cool, Warm, Bright, Dark filters
  • Swipe left/right gesture support for quick filter navigation
  • Filter name overlay display when selecting filters
  • Color filter picker with visual preview

• Theme Customization System: Complete theming support for StoryMaker

  • StoryMakerTheme class for comprehensive UI customization
  • Customizable colors, borders, shadows, and border radius
  • Pre-built dark and light theme variants
  • Theme provider system for easy access throughout widget tree
  • Support for custom button styles and decorations

• Custom Done Button Builder: Added flexibility for custom done button implementation

  • doneButtonBuilder parameter for complete control over done button appearance
  • Access to theme, onDone callback, and loading state

Improvements #

• UI Constants: Centralized all magic numbers and UI constants in ui_constants.dart

  • Viewport fractions, position thresholds, font size constraints
  • Better maintainability and easier configuration

• Enhanced User Experience:

  • Style name overlay when changing font families
  • Filter name overlay when changing color filters
  • Haptic feedback on color and filter selection
  • Improved gesture handling for filter navigation

• Code Quality:

  • Better code organization with new utility files
  • Improved documentation throughout the codebase
  • Enhanced type safety with new model classes (StickerItem)

New Files #

• lib/components/sticker_selector_widget.dart - Sticker selection UI
• lib/components/text_animation_selector_widget.dart - Text animation selector (prepared for future use)
• lib/constants/color_filters.dart - Color filter definitions and matrices
• lib/constants/stickers.dart - Default sticker emoji list
• lib/constants/text_animations.dart - Text animation type definitions
• lib/constants/ui_constants.dart - Centralized UI constants
• lib/models/sticker_item.dart - Sticker item model class
• lib/theme/story_maker_theme.dart - Theme customization class
• lib/theme/story_maker_theme_provider.dart - Theme provider widget
• lib/utils/animation_util.dart - Animation utility functions

Breaking Changes #

• None - All new features are backward compatible

Notes #

• Text animations infrastructure is prepared but not yet fully integrated into the main editor

Developer Experience Improvements #

• Barrel Files: Added barrel files for better package organization and easier imports
  • lib/constants/constants.dart - Exports all public constants
  • lib/models/models.dart - Exports all public model classes
  • lib/theme/theme.dart - Exports all theme-related classes
  • lib/utils/utils.dart - Exports all utility functions
  • lib/extensions/extensions.dart - Exports all extension methods
  • Developers can now import related APIs from a single file for better organization

Improvements #

• Package Structure: Improved code organization with barrel file pattern
  • Easier to discover and use public APIs
  • Better separation of concerns
  • Maintains backward compatibility with existing imports

Public API Exports #

The following public APIs are now available through barrel files:

• Constants: ColorFilterType, ItemType, TextAnimationType, filter matrices, default stickers, font lists, color lists, gradient lists, UI constants
• Models: EditableItem, StickerItem
• Theme: StoryMakerTheme, StoryMakerThemeProvider
• Utils: createAnimatedText, createShader, getColorFilterMatrix, getFilterName, getAnimationName
• Extensions: BuildContextExtensions

Major Refactoring #

• Package Structure Reorganization: Complete refactoring of package structure for better maintainability

  • All implementation files moved to src/ subdirectories
  • Components: lib/components/src/ - All widget components
  • Constants: lib/constants/src/ - All constant definitions
  • Extensions: lib/extensions/src/ - All extension methods
  • Models: lib/models/src/ - All model classes
  • Theme: lib/theme/src/ - All theme-related classes
  • Utils: lib/utils/src/ - All utility functions

• Barrel Files Enhancement: Improved barrel file structure for better package organization

  • lib/components/components.dart - Exports all component widgets
  • lib/constants/constants.dart - Exports all constants
  • lib/extensions/extensions.dart - Exports all extensions
  • lib/models/models.dart - Exports all models
  • lib/theme/theme.dart - Exports all theme classes
  • lib/utils/utils.dart - Exports all utilities

Improvements #

• Code Organization: Better separation of public API from implementation

  • Public API exposed through barrel files
  • Implementation details hidden in src/ directories
  • Follows Dart package best practices

• Import Simplification: Updated internal imports to use barrel files

  • Reduced import statements in main library file
  • Cleaner and more maintainable code structure

• Code Cleanup: Removed unused code

  • Removed animation_util.dart (unused animation utilities)
  • Removed text_animation_selector_widget.dart (prepared but unused feature)

• Bug Fixes:

  • Fixed typo in import statement (constats → constants)
  • Updated deprecated withOpacity() to withValues(alpha:) for Flutter 3.0+ compatibility

Breaking Changes #

• None - All changes are internal refactoring. Public API remains backward compatible.

Developer Experience #

• Better Package Structure: Easier to navigate and understand package organization
• Improved Maintainability: Clear separation between public API and implementation
• Follows Best Practices: Aligns with Dart package structure recommendations