From 803bcb9b862bc417f7435a5734a6fdedc5c49bad Mon Sep 17 00:00:00 2001
From: DreamPiggy <lizhuoli1126@126.com>
Date: Mon, 24 Feb 2025 16:05:48 +0800
Subject: [PATCH] Bumped version to 5.21.0

update CHANGELOG
---
 CHANGELOG.md        | 25 +++++++++++++++++++++++++
 SDWebImage.json     |  3 ++-
 SDWebImage.podspec  |  2 +-
 WebImage/Info.plist |  4 ++--
 4 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b7b8699a..e3f49eb1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,28 @@
+## [5.21.0 - HDR Support on Feb 24th, 2025]
+See [all tickets marked for the 5.21.0 release](https://github.com/SDWebImage/SDWebImage/milestone/142)
+
+### Features
+#### HDR Decoding
+- Supports HDR decoding on Apple ImageIO coder (avif/heic/jpeg-xl, etc) #3778
+- - Note: Defaults to always use SDR, if you want HDR decoding, pass `SDWebImageContextDecodeToHDR: @(YES)` to context option. Pay attention even decoded CGImage is HDR ready, full rendering require display hardware support and per-image-view level control, it's recommended to read [WWDC23](https://developer.apple.com/videos/play/wwdc2023/10181/) and use proper API to check for current display headroom to turn on HDR.
+- - Note: Apple ImageIO coder requires macOS 14/iOS 17+ for HDR decoding. For lower firmware you can consider AVIF/HEIF/JPEG-XL [third-party codec](https://github.com/SDWebImage/SDWebImage/wiki/Coder-Plugin-List)
+
+#### HDR Encoding
+- Supports HDR encoding on Apple ImageIO coder #3799
+- - Note: Defaults to always use SDR, if you want HDR dencoding, pass `SDImageCoderEncodeToHDR: @(SDImageHDRTypeISOHDR)` for ISO HDR encoding. And `SDImageHDRTypeISOGainMap` for ISO Gain Map based HDR encoding (like JPEG for compatibility)
+- - Note: Apple ImageIO coder requires macOS 15/iOS 18+ for HDR encoding. For lower firmware you can consider AVIF/HEIF/JPEG-XL [third-party codec](https://github.com/SDWebImage/SDWebImage/wiki/Coder-Plugin-List)
+
+### Transformer
+- Allows user to directly customize preserveImageMetadata for our built-in transformers #3796
+
+### UI Category
+- Change the default callback queue policy to SafeAsyncMainThread, don't need main queue check at all #3797
+- - Note: This should make `sd_setImageWithURL` related UI API to work on case like `UICollectionViewDiffableDataSource` , which is running on main thread but not main queue.
+
+### Fixes
+- fix: sd_colorAtPoint/sd_colorsWithRect should early return when pixel format is not supported #3798
+- - Note: In history this may return a wrong color for RGB10/RGB16 pixel format. Now it just return nil, which may supported in the future.
+
 ## [5.20.1 - 5.20 Patch on Feb 20th, 2025]
 See [all tickets marked for the 5.20.1 release](https://github.com/SDWebImage/SDWebImage/milestone/141)
 
diff --git a/SDWebImage.json b/SDWebImage.json
index 79a2c00f..ef99a7ba 100644
--- a/SDWebImage.json
+++ b/SDWebImage.json
@@ -6,5 +6,6 @@
     "5.19.6": "https://github.com/SDWebImage/SDWebImage/releases/download/5.19.6/SDWebImage-dynamic.xcframework.zip",
     "5.19.7": "https://github.com/SDWebImage/SDWebImage/releases/download/5.19.7/SDWebImage-dynamic.xcframework.zip",
     "5.20.0": "https://github.com/SDWebImage/SDWebImage/releases/download/5.20.0/SDWebImage-dynamic.xcframework.zip",
-    "5.20.1": "https://github.com/SDWebImage/SDWebImage/releases/download/5.20.1/SDWebImage-dynamic.xcframework.zip"
+    "5.20.1": "https://github.com/SDWebImage/SDWebImage/releases/download/5.20.1/SDWebImage-dynamic.xcframework.zip",
+    "5.21.0": "https://github.com/SDWebImage/SDWebImage/releases/download/5.21.0/SDWebImage-dynamic.xcframework.zip"
 }
diff --git a/SDWebImage.podspec b/SDWebImage.podspec
index 908c8c3a..5fefa776 100644
--- a/SDWebImage.podspec
+++ b/SDWebImage.podspec
@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name = 'SDWebImage'
-  s.version = '5.20.1'
+  s.version = '5.21.0'
 
   s.osx.deployment_target = '10.11'
   s.ios.deployment_target = '9.0'
diff --git a/WebImage/Info.plist b/WebImage/Info.plist
index f2ab2918..8f69e6fd 100644
--- a/WebImage/Info.plist
+++ b/WebImage/Info.plist
@@ -15,11 +15,11 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>5.20.1</string>
+	<string>5.21.0</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>
-	<string>5.20.1</string>
+	<string>5.21.0</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
 </dict>