cached_network_image_ce

• Feature: Added animate to CachedNetworkImage and CachedNetworkImageProvider (default true). With animate: false a multi-frame image such as a GIF shows its first frame and stops there, without decoding the rest. animate is part of the provider key, so toggling it at runtime resolves a different image stream: the widget paints nothing while that stream resolves, and which frame it starts on depends on what the ImageCache still holds. Wrap the widget in a TickerMode to pause and resume an animation in place. Requested in issue #21.
• Fix: CachedNetworkImage.evictFromCache now forwards cacheKey to the provider it evicts and clears both the animate: true and animate: false entries, so the in-memory ImageCache eviction is no longer a silent no-op for images rendered with a cacheKey or with animate: false.

fix: Prevent crashes and memory leaks in MultiImageStreamCompleter du…

• Feature: Added CachedNetworkImage.preCache() static method for downloading and caching images without rendering them. Useful for warming the cache before navigation. Supports optional cacheKey, headers, custom cacheManager, disk-resize parameters (maxWidthDiskCache, maxHeightDiskCache), and an optional timeout. Throws a StateError instead of silently returning a stale file when refreshing an expired cache entry fails, and an ArgumentError (not just an assert) when resize parameters are used with a CacheManager that isn't an ImageCacheManager.

• Fix: PathNotFoundException when the background cleanup sweep deleted a cached file after getFileFromCache had already handed out its FileInfo but before the image was read. The sweep starts unawaited during initialization, so on cold start every first-frame load raced it. A cached file that disappears mid-read now falls back to a fresh download instead of throwing. Applies to the resize path too, which reads the separately-evictable original entry.
• Fix: getImageFile removed its in-flight resize entry only after its stream completed, so abandoning that stream left every later call for the same key waiting on a stream that had already finished, and no image was ever delivered.
• Fix: putFile now awaits its Hive metadata write instead of returning while the write is still unsequenced.
• Behaviour change: The cleanup sweep skips entries served within the last 30 seconds, so an image still being loaded is not evicted out from under its reader. Skipped entries lose their place in the eviction order but not the size budget, so maxNrOfCacheObjects is still honoured.

reported by @aycasecr — thanks! (PR #62)

• Performance: DefaultCacheManager now reuses a single HTTP client across downloads instead of creating and closing one per request, so connections can be kept alive between images.
• Fix: A connection timeout now aborts the in-flight request instead of leaving it running in the background.
• Fix: dispose() closes the reused client. Downloads started after disposal create their own client, which is closed once its last response is released.
• Behaviour change: dispose() called while a download is in flight now aborts that download; previously each download owned its client and could outlive dispose().
• Behaviour change: An onResponse interceptor that replaces the response must not derive the replacement body from the original response's stream — the original body is now canceled as soon as it is replaced, to release its connection.

contributed by @Chlx42 — thanks! (PR #58)

The default HtmlImage web render method decodes through the browser's
native pipeline and never has raw bytes available, so decode failures
there never surface as UnsupportedImageFormatException. Clarify this in
the field doc and README so the mechanism isn't overclaimed as working
on Web unconditionally.

chore: bump version to 4.9.0 and update CHANGELOG

fix(cache): re-read fresh metadata in _touchEntry, final-class CacheE…

chore: bump version to 4.7.0 and update CHANGELOG

chore: update version to 4.6.4 and add changelog entry for Hive key s…

chore: Update version numbers to 4.6.3 and 2.1.1 in pubspec.yaml and …

fix: Update CHANGELOG for version 4.6.2, fixes Hive box corruption re…

• Fix: Re-export ConnectionParameters from the main cached_network_image_ce barrel file so it is accessible without a separate cached_network_image_platform_interface_ce import.
• Fix: Added missing connectionParameters parameter to the stub DefaultCacheManager for unsupported platforms.
• Added example demonstrating DefaultCacheManager with ConnectionParameters.

• Feature: Added optional HTTP timeout support via ConnectionParameters on DefaultCacheManager.
  • connectionTimeout limits time waiting for response headers.
  • requestTimeout applies an inactivity timeout while streaming response bytes.
  • Existing behavior is preserved when connectionParameters is not provided.
• Added tests for timeout behavior and client cleanup on timeout.

• Feature: Added web platform support. The package can now be used in Flutter web apps.
  • Web caching uses Hive CE backed by IndexedDB — no new dependencies needed.
  • Image bytes and metadata are stored in Hive boxes on web instead of the file system.
  • Disk-based image resizing is skipped on web (originals are cached as-is).
  • The DefaultCacheManager is now conditionally imported per platform (IO/web).

• Feature: Skip placeholder and fade animations when images are loaded from disk cache. Cached images now appear instantly without unnecessary visual flicker.
• Added disablePlaceholderOnCacheHit parameter (default true) to opt out of this behavior.
• CachedNetworkImage is now a StatefulWidget to support async cache pre-checking.

• Feature/Deprecation: Added errorBuilder to CachedNetworkImage and CachedImageWidget, which aligns with Flutter's standard ImageErrorWidgetBuilder. The old errorWidget property is now deprecated.
• Fix: Resolved a memory leak where errorListener would prevent CachedNetworkImage from being garbage collected. Uses addEphemeralErrorListener on Flutter >= 3.16.

• Feature: Added SVG support via new unsupportedImageBuilder callback
  • New UnsupportedImageFormatException thrown when image format is not supported by Flutter's standard codec
  • New ImageFormatDetector utility with content sniffing for SVG detection
  • Images are still cached normally; only rendering path differs
  • Example app updated with SVG demo using flutter_svg
  • 24 new tests added (18 format detection + 6 widget integration)
  • See README for usage example

• Fix: Removed global Hive.init() usage from DefaultCacheManager to avoid conflicts with host app Hive initialization
• Fix: Added initialization synchronization in DefaultCacheManager to prevent parallel cold-start race conditions
• Fix: Switched cache metadata box opening to explicit openBox(path: ...) on a private Hive instance for reliable isolation
• Feature: Added optional cacheDirectoryProvider parameter to DefaultCacheManager so apps can control cache storage location
• Tests: Added regression tests for Hive init conflicts, concurrent initialization races, and cache directory resilience scenarios

• Feature: Added httpClientFactory parameter to DefaultCacheManager for HTTP client dependency injection, enabling easy mocking in tests
• Refactor: Replaced raw Map<String, dynamic> with typed CacheEntryMetadata class for all cache metadata operations
• Tests: Comprehensive test coverage (131 tests, 86% coverage)
  • DefaultCacheManager: HTTP download success/errors, progress reporting, header forwarding, cache hit/miss/stale behavior, cleanup logic (31 tests)
  • Leak tests: StreamController closure, http.Client cleanup, file sink closure, ImageLoader chunkEvents, MultiImageStreamCompleter disposal, Hive box lifecycle (19 tests)
  • ImageLoader, CachedNetworkImageProvider, CacheEntryMetadata coverage
• Fix: Resolved analyzer warnings across all packages

• Added repository field for pub.dev source code display
• Updated README with benchmarks and architectural details
• Updated dependencies to _ce suffixed packages