shard 1.0.0-dev.1 copy "shard: ^1.0.0-dev.1" to clipboard
shard: ^1.0.0-dev.1 copied to clipboard

Published 2 days ago • verified publishersaktepe.com• Latest: 0.3.0 / Prerelease: 1.0.0-dev.1
SDKFlutter
PlatformAndroidiOSLinuxmacOSwebWindows
→

Metadata

A powerful, lightweight state management solution for Flutter with built-in persistence, debounce, throttle, and seamless widget integration.

More...

1.0.0-dev.1 #

  • New: [ShardLocator] for singleton registration
    • registerSingleton<T>(T instance) - Register an existing instance
    • registerLazySingleton<T>(T Function() factory) - Register a factory, instantiated on first [get]
    • get<T>() - Resolve the registered singleton
    • isRegistered<T>() - Check if a type is registered
    • reset() - Clear all registrations (e.g. in test setUp)
  • New: stateSerializer<T>() factory function for JSON-based serialization
    • Eliminates the need to create separate serializer classes
    • Works with any object that has toJson() and fromJson() methods
    • Supports lists, maps, and nested objects
  • New: [StringSerializer] for simple string state persistence

0.3.0 #

  • New: Built-in caching support for [FutureShard]
  • New: [CacheService] interface for cache storage backends
  • New: [MemoryCacheService] singleton for in-memory caching
  • New: [CacheEntry] class for cache entries with expiration
  • New: [CacheMixin] for repository-level caching with resolve method

0.2.0 #

  • BREAKING CHANGE: PersistentShard<T> is now PersistentShard<T, K>
    • T - Full state type
    • K - Persistence data type (can be a subset of T)
    • Allows persisting only the data you need, excluding loading states, errors, etc.
  • BREAKING CHANGE: StatePersistenceMixin<T> is now StatePersistenceMixin<T, K>
  • BREAKING CHANGE: Added onLoadComplete(K? data) callback
    • Called when load operation completes (replaces automatic state update)
    • Receives the loaded data as parameter
    • null is passed when storage is empty (first launch)
    • Developers have full control over how loaded data is merged into state
  • BREAKING CHANGE: New abstract method toPersistence(T state) required
    • Extracts the data to persist from the current state
  • BREAKING CHANGE: StateSerializer<T> is now StateSerializer<K> in persistence config
  • BREAKING CHANGE: Removed clear() method from StateStorage interface
    • The clear() method was removed because it cleared all storage data, which is not useful for developers
    • Developers can reset state by using emit(initialState) - auto-save will automatically sync to storage
  • BREAKING CHANGE: Removed clearStorage() method from StatePersistenceMixin
  • BREAKING CHANGE: Removed clear() method from PersistentShard
    • Developers now have full control over state reset using emit() method
  • New: SimplePersistentShard<T> class for simple cases
    • Use when state type and persistence type are the same
    • No need to override toPersistence or onLoadComplete
    • Reduces boilerplate for simple use cases

0.1.0 #

  • Added MultiShardProvider widget. Simplifies providing multiple shards to the widget tree
  • Type-safety improvements
    • Removed unsafe dynamic casts in widget layer
    • Improved generic type preservation throughout the widget tree
    • Better compile-time type checking
  • Development improvements
    • Added flutter_lints as dev dependency for better code quality

0.0.2 #

  • Updated package metadata and documentation links
  • Added homepage URL pointing to documentation site
  • Added issue tracker link
  • Added documentation URL
  • Added package topics for better discoverability
  • Removed flutter_lints dependency from dev_dependencies

0.0.1 #

  • Initial release of Shard - A powerful, lightweight state management solution for Flutter
  • Core state management with [Shard] class
  • Built-in persistence support with [PersistentShard]
  • Async state management with [FutureShard] and [StreamShard]
  • Debounce and throttle mixins
  • Widget integration with [ShardProvider], [ShardBuilder], and [ShardSelector]
  • Observer pattern for global state monitoring

← Metadata

4
likes
160
points
475
downloads

Publisher

verified publishersaktepe.com

Weekly Downloads

Metadata

A powerful, lightweight state management solution for Flutter with built-in persistence, debounce, throttle, and seamless widget integration.

Homepage
Repository (GitHub)
View/report issues

Topics

#shard #state-management

Documentation

Documentation
API reference

License

MIT (license)

Dependencies

flutter

More

Packages that depend on shard

Back