diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..046729a --- /dev/null +++ b/.gitignore @@ -0,0 +1,2 @@ +Demo/Bulletin.xcodeproj/project.xcworkspace/xcuserdata/pranav.xcuserdatad/UserInterfaceState.xcuserstate +Demo/Bulletin.xcodeproj/xcuserdata/pranav.xcuserdatad/xcschemes/xcschememanagement.plist diff --git a/BulletinSDK/BulletinDataStore.swift b/BulletinSDK/BulletinDataStore.swift new file mode 100644 index 0000000..d4535b6 --- /dev/null +++ b/BulletinSDK/BulletinDataStore.swift @@ -0,0 +1,87 @@ +// +// BulletinDataStore.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import Foundation + +class BulletinDataStore { + + + // MARK: - Variable + public private(set) var data = [BulletinInfo]() + + + // MARK: - Initialisation Methods + public init() {} + + public init?(attributes: [String : Any]) { + + } + + + // MARK: - Helper Methods + public func registerVersionInfo(version: Version, items: [[String: Any]]) { + + var bulletinItems = [BulletinItem]() + for itemAttributes in items { + guard let bulletinItem = BulletinItem.createBulletinItem(forAttributes: itemAttributes) else { continue } + bulletinItems.append(bulletinItem) + } + + registerVersionInfo(version: version, items: bulletinItems) + } + + public func registerVersionInfo(version: Version, items: [BulletinItem]) { + + // Validation + guard items.isEmpty == false else { return } + + // Create Bulletin Info Object + let bulletinInfo = BulletinInfo(version: version, items: items) + + for (i,item) in data.enumerated() { + + // Check If Same Version Available In Data + if item.version == version { + + // Remove Value + data.remove(at: i) + + // Add New Value + data.append(bulletinInfo) + return + } + } + + data.append(bulletinInfo) + } + + public func getData(fromNewVersion newVersion: Version?, toOldVersion oldVersion: Version?, limit: Int? = nil) -> [BulletinInfo]? { + + // Sort Bulletin Info + let sortedInfos = data.sorted(by: { $0.version > $1.version }) + + var filteredInfos = [BulletinInfo]() + for info in sortedInfos { + + // Add Info Only When Conditions Are True + if let newVersion = newVersion, info.version <= newVersion { + filteredInfos.append(info) + } else if let oldVersion = oldVersion, info.version >= oldVersion { + filteredInfos.append(info) + } else { + filteredInfos.append(info) + } + + // Validation For Limit + if let limit = limit, filteredInfos.count >= limit { + return filteredInfos + } + } + + return filteredInfos + } +} diff --git a/BulletinSDK/BulletinSDK.swift b/BulletinSDK/BulletinSDK.swift new file mode 100644 index 0000000..c4042bd --- /dev/null +++ b/BulletinSDK/BulletinSDK.swift @@ -0,0 +1,84 @@ +// +// BulletinSDK.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import Foundation + +class BulletinSDK { + + + // MARK: - Variables + public let dataStore: BulletinDataStore + + + // MARK: Initialisation Method + public init(dataStore: BulletinDataStore, appearance: Appearance) { + + // Set Data Store + self.dataStore = dataStore + applyAppearance(theme: appearance) + } + + + // MARK: - Helper Methods + public func getFullBulletin() -> BulletinListVC? { + + // Get Bulletin Items + let items = dataStore.getData(fromNewVersion: nil, toOldVersion: nil) + + // Show Bulletin + return getBulletin(items: items) + } + + public func getLastBulletins(limit: Int = 1) -> BulletinListVC? { + + // Get Bulletin Items + let items = dataStore.getData(fromNewVersion: nil, toOldVersion: nil, limit: limit) + + // Show Bulletin + return getBulletin(items: items) + } + + public func getUnseenBulletins(limit: Int? = nil) -> BulletinListVC? { + + // Get Last Seen Version + guard let lastSeenVersion = UserDefaults.lastSeenVersion else { return nil } + + // Get Bulletin Items + let items = dataStore.getData(fromNewVersion: lastSeenVersion, toOldVersion: nil, limit: limit) + + // Show Bulletin + return getBulletin(items: items) + } + + private func getBulletin(items: [BulletinInfo]?) -> BulletinListVC? { + + // Validation + guard let items = items, + items.isEmpty == false else { return nil } + + let bulletinListVC = BulletinListVC.instance(items: items) + + return bulletinListVC + } + + private func applyAppearance(theme: Appearance) { + + // Apply Theme + switch theme { + case .darkKnight: + + // Apply Dark Knight Theme + Appearance.darkKnight.apply(shouldBroadcastUpdate: true) + + case .whiteKnight: + + // Apply Dark Knight Theme + Appearance.whiteKnight.apply(shouldBroadcastUpdate: true) + } + + } +} diff --git a/BulletinSDK/Classes/Base/View/BaseCollectionViewCell.swift b/BulletinSDK/Classes/Base/View/BaseCollectionViewCell.swift new file mode 100644 index 0000000..6e77506 --- /dev/null +++ b/BulletinSDK/Classes/Base/View/BaseCollectionViewCell.swift @@ -0,0 +1,45 @@ +// +// BaseTableViewCell.swift +// Bulletin +// +// Created by Daxesh Nagar on 17/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +class BaseCollectionViewCell: UICollectionViewCell { + + // MARK: - Constants + public class func identifier() -> String { + return String(describing: self) + } + + + // MARK: - Initialisation Methods + override func awakeFromNib() { + super.awakeFromNib() + + if #available(iOS 13.0, *) { + layer.cornerCurve = .continuous + } + + // Load Variables + loadVariables() + + // Update Appearance + updateAppearance() + + } + + + // MARK: - Override Methods + open func loadVariables() { + // Override This Method In Subclass To Initialize Variables + } + + open func updateAppearance() { + // Override This Method In Subclass To Set/Update Appearance + } + +} diff --git a/BulletinSDK/Classes/Categories/NSAttributedString+Utility.swift b/BulletinSDK/Classes/Categories/NSAttributedString+Utility.swift new file mode 100644 index 0000000..0342a93 --- /dev/null +++ b/BulletinSDK/Classes/Categories/NSAttributedString+Utility.swift @@ -0,0 +1,20 @@ +// +// NSAttributedString+Utility.swift +// Bulletin +// +// Created by Daxesh Nagar on 21/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import Foundation + +extension NSAttributedString { + + var trailingNewlineChopped: NSAttributedString { + if string.hasSuffix("\n") { + return attributedSubstring(from: NSRange(location: 0, length: length - 1)) + } else { + return self + } + } +} diff --git a/BulletinSDK/Classes/Categories/String+HTML.swift b/BulletinSDK/Classes/Categories/String+HTML.swift new file mode 100644 index 0000000..cb0e2e3 --- /dev/null +++ b/BulletinSDK/Classes/Categories/String+HTML.swift @@ -0,0 +1,38 @@ +// +// String+HTML.swift +// Bulletin +// +// Created by Daxesh Nagar on 21/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +extension String { + + public func html2AttributedString(usingFont font: UIFont?, color: UIColor = .black) -> NSMutableAttributedString? { + + let text : String + + // Add Font Attributes + if let font = font { + let colorHashCode = color.hexString() + let startTag = "" + let endTag = "" + text = (startTag + self + endTag) + } + else { + text = self as String + } + + // Convert HTML To Attributed String + do { + return try NSMutableAttributedString(data: Data(text.utf8), options: [.documentType: NSAttributedString.DocumentType.html, .characterEncoding: String.Encoding.utf8.rawValue], documentAttributes: nil) + } catch { + print("error:", error) + return nil + } + + } +} + diff --git a/BulletinSDK/Classes/Categories/String+Unicode.swift b/BulletinSDK/Classes/Categories/String+Unicode.swift new file mode 100644 index 0000000..ad41174 --- /dev/null +++ b/BulletinSDK/Classes/Categories/String+Unicode.swift @@ -0,0 +1,21 @@ +// +// String+Unicode.swift +// Bulletin +// +// Created by Daxesh Nagar on 26/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import Foundation + +extension String { + + var unicodeString: String? { + if let charCode = UInt32(self, radix: 16), + let unicode = UnicodeScalar(charCode) { + let str = String(unicode) + return str + } + return nil + } +} diff --git a/BulletinSDK/Classes/Categories/UILabel+FontStyle.swift b/BulletinSDK/Classes/Categories/UILabel+FontStyle.swift new file mode 100644 index 0000000..94f46e2 --- /dev/null +++ b/BulletinSDK/Classes/Categories/UILabel+FontStyle.swift @@ -0,0 +1,146 @@ +// +// UILabel+FontStyle.swift +// Bulletin +// +// Created by Daxesh Nagar on 18/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + + +extension UILabel { + + + // MARK: - Heading 1 Methods + public func heading1_regular() { + font = AppStyle.Font.Regular(size: 48) + } + public func heading1_bold() { + font = AppStyle.Font.Bold(size: 48) + } + public func heading1_semibold() { + font = AppStyle.Font.SemiBold(size: 48) + } + + + // MARK: - Heading 2 Methods + public func heading2_regular() { + font = AppStyle.Font.Regular(size: 32) + } + public func heading2_bold() { + font = AppStyle.Font.Bold(size: 32) + } + public func heading2_semibold() { + font = AppStyle.Font.SemiBold(size: 32) + } + + + // MARK: - Heading 3 Methods + public func heading3_regular() { + font = AppStyle.Font.Regular(size: 25) + } + public func heading3_bold() { + font = AppStyle.Font.Bold(size: 25) + } + public func heading3_semibold() { + font = AppStyle.Font.SemiBold(size: 25) + } + + + // MARK: - Heading 4 Methods + public func heading4_regular() { + font = AppStyle.Font.Regular(size: 22) + } + public func heading4_bold() { + font = AppStyle.Font.Bold(size: 22) + } + public func heading4_semibold() { + font = AppStyle.Font.SemiBold(size: 22) + } + + + // MARK: - Heading 5 Methods + public func heading5_regular() { + font = AppStyle.Font.Regular(size: 20) + } + public func heading5_bold() { + font = AppStyle.Font.Bold(size: 20) + } + public func heading5_semibold() { + font = AppStyle.Font.SemiBold(size: 20) + } + + + // MARK: - Heading 6 Methods + public func heading6_regular() { + font = AppStyle.Font.Regular(size: 18) + } + public func heading6_bold() { + font = AppStyle.Font.Bold(size: 18) + } + public func heading6_semibold() { + font = AppStyle.Font.SemiBold(size: 18) + } + + + // MARK: - Large Methods + public func large_regular() { + font = AppStyle.Font.Regular(size: 16) + } + public func large_bold() { + font = AppStyle.Font.Bold(size: 16) + } + public func large_semibold() { + font = AppStyle.Font.SemiBold(size: 16) + } + public func large_medium() { + font = AppStyle.Font.Medium(size: 16) + } + + + // MARK: - Base Methods + public func base_regular() { + font = AppStyle.Font.Regular(size: 14) + } + public func base_bold() { + font = AppStyle.Font.Bold(size: 14) + } + public func base_semibold() { + font = AppStyle.Font.SemiBold(size: 14) + } + public func base_medium() { + font = AppStyle.Font.Medium(size: 14) + } + + + // MARK: - Small Methods + public func small_regular() { + font = AppStyle.Font.Regular(size: 12) + } + public func small_bold() { + font = AppStyle.Font.Bold(size: 12) + } + public func small_semibold() { + font = AppStyle.Font.SemiBold(size: 12) + } + public func small_medium() { + font = AppStyle.Font.Medium(size: 12) + } + + + // MARK: - xSmall Methods + public func xsmall_regular() { + font = AppStyle.Font.Regular(size: 11) + } + public func xsmall_bold() { + font = AppStyle.Font.Bold(size: 11) + } + public func xsmall_semibold() { + font = AppStyle.Font.SemiBold(size: 11) + } + public func xsmall_medium() { + font = AppStyle.Font.Medium(size: 11) + } +} + diff --git a/BulletinSDK/Classes/Categories/UIView+SubviewAspectSize.swift b/BulletinSDK/Classes/Categories/UIView+SubviewAspectSize.swift new file mode 100644 index 0000000..e2cdabe --- /dev/null +++ b/BulletinSDK/Classes/Categories/UIView+SubviewAspectSize.swift @@ -0,0 +1,66 @@ +// +// UIView+SubviewAspectSize.swift +// Bulletin +// +// Created by Daxesh Nagar on 26/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +extension UIView { + + // Get Subview Aspect Size + func subviewAspectSizeWithPadding(padding: CGFloat, subviewWidth: CGFloat, subviewHeight: CGFloat) -> CGSize { + let viewWidth = frame.size.width - padding + let viewHeight = ((frame.size.width - padding) / frame.size.width) * frame.size.height + + var newSubviewWidth: CGFloat = 0 + var newSubviewHeight: CGFloat = 0 + + if viewWidth < viewHeight { + // View Height Is Large + newSubviewWidth = viewWidth + newSubviewHeight = getNewSubviewHeight(using: newSubviewWidth, subviewWidth: subviewWidth, subviewHeight: subviewHeight) + + if newSubviewHeight > viewHeight { + newSubviewHeight = viewHeight + newSubviewWidth = getNewSubviewWidth(using: newSubviewHeight, subviewWidth: subviewWidth, subviewHeight: subviewHeight) + } + } + else { + // View Width Is Large + newSubviewHeight = viewHeight + newSubviewWidth = getNewSubviewWidth(using: newSubviewHeight, subviewWidth: subviewWidth, subviewHeight: subviewHeight) + + if newSubviewWidth > viewWidth { + newSubviewWidth = viewWidth + newSubviewHeight = getNewSubviewHeight(using: newSubviewWidth, subviewWidth: subviewWidth, subviewHeight: subviewHeight) + } + } + + return CGSize(width: newSubviewWidth, height: newSubviewHeight) + } + + // Get Subview Aspect Height + func getAspectHeightForSubView(subviewWidth: CGFloat, subviewHeight: CGFloat) -> CGFloat { + let viewWidth = frame.size.width + let viewHeight = frame.size.height + + var newSubviewWidth: CGFloat = viewWidth + var newSubviewHeight: CGFloat = getNewSubviewHeight(using: newSubviewWidth, subviewWidth: subviewWidth, subviewHeight: subviewHeight) + + return newSubviewHeight + } + + // Get New Subview Proportional Width + func getNewSubviewWidth(using newSubviewHeight: CGFloat, subviewWidth: CGFloat, subviewHeight: CGFloat) -> CGFloat { + return (newSubviewHeight * subviewWidth) / subviewHeight + } + + // Get New Subview Proportional Height + func getNewSubviewHeight(using newSubviewWidth: CGFloat, subviewWidth: CGFloat, subviewHeight: CGFloat) -> CGFloat { + return (newSubviewWidth * subviewHeight) / subviewWidth + } +} + diff --git a/BulletinSDK/Classes/Constants/Appearance.swift b/BulletinSDK/Classes/Constants/Appearance.swift new file mode 100644 index 0000000..95c70a0 --- /dev/null +++ b/BulletinSDK/Classes/Constants/Appearance.swift @@ -0,0 +1,520 @@ +// +// WZAppearance.swift +// WazirX +// +// Created by Daxesh Nagar on 17/07/23. +// Copyright © 2017 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit +import UIColor_Hex_Swift + +public enum Appearance: String { + + // MARK: Types + case darkKnight + case whiteKnight + + + // MARK: Constants + public static func DefaultAnimationDuration() -> TimeInterval { return 0.3 } + + + // MARK: Conveniance Method To Apply Any Appearance + public func apply(shouldBroadcastUpdate: Bool) { + + // Apply Appropriate Themes + switch self { + case .darkKnight: + applyMidnightBlueAppearance() + case .whiteKnight: + applyDefaultAppearance() + } + + // Broadcast Appearance Update Notification + if shouldBroadcastUpdate == true { + NotificationCenter.default.post(name: .AppearanceDidUpdate, object: nil, userInfo: nil) + } + } + + + // MARK: Helper Methods + + private func applyDefaultAppearance() { + + // ------- New Color Styles ------- // + AppStyle.Color.MainTextPrimary = AppStyle.ColorTokens.Gray_100 + AppStyle.Color.MainTextSecondary = AppStyle.ColorTokens.Gray_50 + AppStyle.Color.MainTextTertiary = AppStyle.ColorTokens.Gray_40 + + AppStyle.Color.MainBrandPrimary = AppStyle.ColorTokens.Blue_60 + + AppStyle.Color.MainNavigationOnNavigation = AppStyle.ColorTokens.White + AppStyle.Color.MainNavigationBg = AppStyle.ColorTokens.Blue_60 + + AppStyle.Color.MainBgSurface = AppStyle.ColorTokens.Gray_20 + AppStyle.Color.MainBgSurface_Alt = AppStyle.ColorTokens.White + AppStyle.Color.MainBgPrimary = AppStyle.ColorTokens.White + AppStyle.Color.MainBgSecondary = AppStyle.ColorTokens.Gray_10 + AppStyle.Color.MainBgTertiary = AppStyle.ColorTokens.Gray_30 + + AppStyle.Color.BrandTextPrimary = AppStyle.ColorTokens.Blue_60 + AppStyle.Color.BrandTextSecondary = AppStyle.ColorTokens.Blue_30 + AppStyle.Color.BrandTextOnMuted = AppStyle.ColorTokens.Blue_60 + AppStyle.Color.BrandTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.BrandBgPrimary = AppStyle.ColorTokens.Blue_60 + AppStyle.Color.BrandBgMuted = AppStyle.ColorTokens.Blue_10 + AppStyle.Color.BrandBgMuted_Border = AppStyle.ColorTokens.Blue_20 + + AppStyle.Color.SuccessTextPrimary = AppStyle.ColorTokens.Green_60 + AppStyle.Color.SuccessTextOnMuted = AppStyle.ColorTokens.Green_60 + AppStyle.Color.SuccessTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.SuccessBgPrimary = AppStyle.ColorTokens.Green_60 + AppStyle.Color.SuccessBgMuted = AppStyle.ColorTokens.Green_10 + AppStyle.Color.SuccessBgMuted_Border = AppStyle.ColorTokens.Green_20 + + AppStyle.Color.DangerTextPrimary = AppStyle.ColorTokens.Red_60 + AppStyle.Color.DangerTextOnMuted = AppStyle.ColorTokens.Red_60 + AppStyle.Color.DangerTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.DangerBgPrimary = AppStyle.ColorTokens.Red_60 + AppStyle.Color.DangerBgMuted = AppStyle.ColorTokens.Red_10 + AppStyle.Color.DangerBgMuted_Border = AppStyle.ColorTokens.Red_20 + + AppStyle.Color.WarningTextPrimary = AppStyle.ColorTokens.Yellow_70 + AppStyle.Color.WarningTextOnMuted = AppStyle.ColorTokens.Yellow_90 + AppStyle.Color.WarningTextOnPrimary = AppStyle.ColorTokens.Yellow_100 + AppStyle.Color.WarningBgPrimary = AppStyle.ColorTokens.Yellow_50 + AppStyle.Color.WarningBgMuted = AppStyle.ColorTokens.Yellow_20 + AppStyle.Color.WarningBgMuted_Border = AppStyle.ColorTokens.Yellow_30 + + AppStyle.Color.Brand_AltTextPrimary = AppStyle.ColorTokens.Orange_60 + AppStyle.Color.Brand_AltTextSecondary = AppStyle.ColorTokens.Orange_30 + AppStyle.Color.Brand_AltTextOnMuted = AppStyle.ColorTokens.Orange_60 + AppStyle.Color.Brand_AltTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.Brand_AltBgPrimary = AppStyle.ColorTokens.Orange_60 + AppStyle.Color.Brand_AltBgMuted = AppStyle.ColorTokens.Orange_10 + AppStyle.Color.Brand_AltBgDisabled = AppStyle.ColorTokens.Orange_40 + + AppStyle.Color.AttentionTextPrimary = AppStyle.ColorTokens.Orange_60 + AppStyle.Color.AttentionTextOnMuted = AppStyle.ColorTokens.Orange_60 + AppStyle.Color.AttentionTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.AttentionBgPrimary = AppStyle.ColorTokens.Orange_60 + AppStyle.Color.AttentionBgMuted = AppStyle.ColorTokens.Orange_10 + AppStyle.Color.AttentionBgMuted_Border = AppStyle.ColorTokens.Orange_20 + + AppStyle.Color.MiscHome_Bar = AppStyle.ColorTokens.Black + } + + private func applyMidnightBlueAppearance() { + + + // ------- New Color Styles ------- // + AppStyle.Color.MainTextPrimary = AppStyle.ColorTokens.Gray_30 + AppStyle.Color.MainTextSecondary = AppStyle.ColorTokens.Gray_50 + AppStyle.Color.MainTextTertiary = AppStyle.ColorTokens.Gray_60 + + AppStyle.Color.MainBrandPrimary = AppStyle.ColorTokens.Blue_40 + + AppStyle.Color.MainNavigationOnNavigation = AppStyle.ColorTokens.Gray_30 + AppStyle.Color.MainNavigationBg = AppStyle.ColorTokens.Gray_80 + + AppStyle.Color.MainBgSurface = AppStyle.ColorTokens.Gray_100 + AppStyle.Color.MainBgSurface_Alt = AppStyle.ColorTokens.Gray_100 + AppStyle.Color.MainBgPrimary = AppStyle.ColorTokens.Gray_80 + AppStyle.Color.MainBgSecondary = AppStyle.ColorTokens.Gray_90 + AppStyle.Color.MainBgTertiary = AppStyle.ColorTokens.Gray_70 + + AppStyle.Color.BrandTextPrimary = AppStyle.ColorTokens.Blue_40 + AppStyle.Color.BrandTextSecondary = AppStyle.ColorTokens.Blue_20 + AppStyle.Color.BrandTextOnMuted = AppStyle.ColorTokens.Blue_40 + AppStyle.Color.BrandTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.BrandBgPrimary = AppStyle.ColorTokens.Blue_40 + AppStyle.Color.BrandBgMuted = AppStyle.ColorTokens.Blue_90 + AppStyle.Color.BrandBgMuted_Border = AppStyle.ColorTokens.Blue_80 + + AppStyle.Color.SuccessTextPrimary = AppStyle.ColorTokens.Green_40 + AppStyle.Color.SuccessTextOnMuted = AppStyle.ColorTokens.Green_30 + AppStyle.Color.SuccessTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.SuccessBgPrimary = AppStyle.ColorTokens.Green_50 + AppStyle.Color.SuccessBgMuted = AppStyle.ColorTokens.Green_80 + AppStyle.Color.SuccessBgMuted_Border = AppStyle.ColorTokens.Green_70 + + AppStyle.Color.DangerTextPrimary = AppStyle.ColorTokens.Red_50 + AppStyle.Color.DangerTextOnMuted = AppStyle.ColorTokens.Red_30 + AppStyle.Color.DangerTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.DangerBgPrimary = AppStyle.ColorTokens.Red_50 + AppStyle.Color.DangerBgMuted = AppStyle.ColorTokens.Red_100 + AppStyle.Color.DangerBgMuted_Border = AppStyle.ColorTokens.Red_90 + + AppStyle.Color.WarningTextPrimary = AppStyle.ColorTokens.Yellow_50 + AppStyle.Color.WarningTextOnMuted = AppStyle.ColorTokens.Yellow_20 + AppStyle.Color.WarningTextOnPrimary = AppStyle.ColorTokens.Yellow_100 + AppStyle.Color.WarningBgPrimary = AppStyle.ColorTokens.Yellow_50 + AppStyle.Color.WarningBgMuted = AppStyle.ColorTokens.Yellow_100 + AppStyle.Color.WarningBgMuted_Border = AppStyle.ColorTokens.Yellow_90 + + AppStyle.Color.Brand_AltTextPrimary = AppStyle.ColorTokens.Blue_40 + AppStyle.Color.Brand_AltTextSecondary = AppStyle.ColorTokens.Blue_20 + AppStyle.Color.Brand_AltTextOnMuted = AppStyle.ColorTokens.Blue_40 + AppStyle.Color.Brand_AltTextOnPrimary = AppStyle.ColorTokens.White + AppStyle.Color.Brand_AltBgPrimary = AppStyle.ColorTokens.Blue_40 + AppStyle.Color.Brand_AltBgMuted = AppStyle.ColorTokens.Blue_90 + AppStyle.Color.Brand_AltBgDisabled = AppStyle.ColorTokens.Blue_40 + + AppStyle.Color.AttentionTextPrimary = AppStyle.ColorTokens.Orange_50 + AppStyle.Color.AttentionTextOnMuted = AppStyle.ColorTokens.Orange_30 + AppStyle.Color.AttentionTextOnPrimary = AppStyle.ColorTokens.Orange_100 + AppStyle.Color.AttentionBgPrimary = AppStyle.ColorTokens.Orange_50 + AppStyle.Color.AttentionBgMuted = AppStyle.ColorTokens.Orange_100 + AppStyle.Color.AttentionBgMuted_Border = AppStyle.ColorTokens.Orange_90 + + AppStyle.Color.MiscHome_Bar = AppStyle.ColorTokens.White + } +} + + +public struct AppStyle { + + // MARK: - Colors + public struct ColorTokens { + + public static var Black = UIColor.black + + public static var White = UIColor.white + + public static var Gray_10 = UIColor("#FBFCFE") + public static var Gray_20 = UIColor("#F2F2F8") + public static var Gray_30 = UIColor("#D9E1EB") + public static var Gray_40 = UIColor("#A0AAB5") + public static var Gray_50 = UIColor("#6F7F90") + public static var Gray_60 = UIColor("#4C5C70") + public static var Gray_70 = UIColor("#2E3E54") + public static var Gray_80 = UIColor("#232F3F") + public static var Gray_90 = UIColor("#212C3A") + public static var Gray_100 = UIColor("#1A212B") + + public static var Red_10 = UIColor("#FFEFEF") + public static var Red_20 = UIColor("#fed7d7") + public static var Red_30 = UIColor("#feb2b2") + public static var Red_40 = UIColor("#fc8181") + public static var Red_50 = UIColor("#f56565") + public static var Red_60 = UIColor("#e53e3e") + public static var Red_70 = UIColor("#c53030") + public static var Red_80 = UIColor("#9b2c2c") + public static var Red_90 = UIColor("#742a2a") + public static var Red_100 = UIColor("#4B2830") + + public static var Yellow_10 = UIColor("#fffff0") + public static var Yellow_20 = UIColor("#fefcbf") + public static var Yellow_30 = UIColor("#faf089") + public static var Yellow_40 = UIColor("#f6e05e") + public static var Yellow_50 = UIColor("#ecc94b") + public static var Yellow_60 = UIColor("#d69e2e") + public static var Yellow_70 = UIColor("#b7791f") + public static var Yellow_80 = UIColor("#975a16") + public static var Yellow_90 = UIColor("#744210") + public static var Yellow_100 = UIColor("#4F3502") + + public static var Green_10 = UIColor("#E0FAEE") + public static var Green_20 = UIColor("#ABEDCF") + public static var Green_30 = UIColor("#7BDBB0") + public static var Green_40 = UIColor("#56C292") + public static var Green_50 = UIColor("#3BA073") + public static var Green_60 = UIColor("#287D57") + public static var Green_70 = UIColor("#1D5E41") + public static var Green_80 = UIColor("#16422E") + public static var Green_90 = UIColor("#123023") + + public static var Blue_10 = UIColor("#E8EEFD") + public static var Blue_20 = UIColor("#B6C9FA") + public static var Blue_30 = UIColor("#96B2F7") + public static var Blue_40 = UIColor("#2DA4FE") + public static var Blue_50 = UIColor("#167CF9") + public static var Blue_60 = UIColor("#3067F0") + public static var Blue_70 = UIColor("#1746BD") + public static var Blue_80 = UIColor("#2A5573") + public static var Blue_90 = UIColor("#19364A") + + public static var Orange_10 = UIColor("#FDEFE9") + public static var Orange_20 = UIColor("#FAE0D4") + public static var Orange_30 = UIColor("#F6C4AD") + public static var Orange_40 = UIColor("#F1A07B") + public static var Orange_50 = UIColor("#EE895B") + public static var Orange_60 = UIColor("#E86427") + public static var Orange_70 = UIColor("#BF5728") + public static var Orange_80 = UIColor("#964929") + public static var Orange_90 = UIColor("#713D29") + public static var Orange_100 = UIColor("#4B312A") + } + + public struct Color { + + public static var Primary = UIColor.black + public static var PrimaryContrast = UIColor.lightGray + public static var Accent = UIColor.lightGray + public static var Accent2 = UIColor.white + public static var Accent2Contrast = UIColor.black + + public static var Background = UIColor.lightGray + public static var BackgroundHighlight = UIColor.lightGray + public static var SegmentSelectedBackground = UIColor.lightGray + public static var SegmentUnselectedBackground = UIColor.lightGray + public static var SegmentUnselectedBackgroundOnNonWhiteBackground = UIColor.lightGray + public static var LightBackground = UIColor.white + public static var LightBackgroundContrast = UIColor.white + public static var DarkBackground = UIColor.lightGray + public static var WalletBallanceDetailsBackground = UIColor.lightGray + + public static var LowEmphasisBackground = UIColor.systemBlue + public static var LowEmphasisText = UIColor.lightText + public static var LowEmphasisSubText = UIColor.lightText + + public static var MediumEmphasisBackground = UIColor.yellow + public static var MediumEmphasisText = UIColor.lightText + public static var MediumEmphasisSubText = UIColor.lightText + + public static var MediumEmphasisButton = UIColor.yellow + public static var MediumEmphasisButtonText = UIColor.lightText + + public static var HighEmphasisBackground = UIColor.red + public static var HighEmphasisText = UIColor.red + public static var HighEmphasisSubText = UIColor.red + + public static var PrimaryText = UIColor.black + public static var SecondaryText = UIColor.lightGray + + public static var NavigationItem = UIColor.white + public static var BannerText = UIColor.black + public static var SecondaryBlueWithAlpha = UIColor("#27A8FF").withAlphaComponent(0.15) + + public static var Loader = UIColor.lightGray + + public static var TabBar = UIColor.white + public static var TabBarItemUnselected = UIColor.lightGray + public static var TabBarItemSelected = Primary + + public static var SwitchOn = UIColor.green + + public static var PrimaryGreen = UIColor.green + public static var PrimaryRed = UIColor.red + + public static var ChartBackground = UIColor.white + public static var ChartGreen = UIColor.green + public static var ChartRed = UIColor.red + public static var Chart2Green = UIColor.green + public static var Chart2Red = UIColor.red + public static var ChartGrid = UIColor.lightGray + public static var ChartText = UIColor.lightGray + public static var ChartAxisLineColor = UIColor.lightGray + + public static var OrderBookGreen = UIColor.green + public static var OrderBookRed = UIColor.red + public static var OrderBookModeButtonColor = UIColor.black + public static var OrderBookModeButtonTextColor = UIColor.white + + public static var TradeHistoryGreen = UIColor.green + public static var TradeHistoryRed = UIColor.red + + public static var CellBackground = UIColor.white + public static var CellBackgroundAlternate = UIColor.white + public static var CellHighlight = UIColor.lightGray + public static var CellIconBackground = Background + public static var CellSeparator = UIColor.lightGray + public static var CellSeparator2 = CellSeparator + + public static var TextFieldStrokeOnPrimaryColor = UIColor.lightGray + public static var TextFieldStrokeOnLightBackground = UIColor.lightGray + + public static var SelectedElement = UIColor.lightGray + public static var Favourite = UIColor.yellow + public static var FavouriteBackground = UIColor.lightGray + + public static var Error = UIColor.red + public static var Success = UIColor.green + + public static var GeneralStatus = UIColor.green + public static var PositiveStatus = UIColor.green + public static var NegativeStatus = UIColor.green + public static var WarningStatus = UIColor.green + + public static var ConnectionBar = UIColor.black + public static var Connecting = UIColor.yellow + public static var Connected = UIColor.green + public static var Disconnected = UIColor.red + + public static var SearchBarCancelButton = UIColor.white + + // For Widget + public static let WidgetPrimaryGreen = UIColor("#4DD964") + public static let WidgetPrimaryRed = UIColor("#FE3B2F") + + public static var PageControlTint = UIColor.blue.withAlphaComponent(0.3) + public static var PageControlSelectedTint = UIColor.blue.withAlphaComponent(0.3) + + // Gift Crypto + public static var GiftCryptoGreen = UIColor("#00C966") + public static var GiftCryptoPink = UIColor("#FF5AC6") + public static var GiftCryptoYellow = UIColor("#FFD410") + public static var GiftCryptoViolet = UIColor("#770CE7") + + // For Step Indicator + public static var CurrentStepIndicator = UIColor.gray + + // ------- New Color Styles ------- // + public static var MainTextPrimary = UIColor.gray + public static var MainTextSecondary = UIColor.gray + public static var MainTextTertiary = UIColor.gray + + public static var MainBrandPrimary = UIColor.blue + + public static var MainNavigationOnNavigation = UIColor.white + public static var MainNavigationBg = UIColor.lightGray + + public static var MainBgSurface = UIColor.gray + public static var MainBgSurface_Alt = UIColor.gray + public static var MainBgPrimary = UIColor.lightGray + public static var MainBgSecondary = UIColor.lightGray + public static var MainBgTertiary = UIColor.lightGray + + public static var BrandTextPrimary = UIColor.black + public static var BrandTextSecondary = UIColor.black + public static var BrandTextOnMuted = UIColor.black + public static var BrandTextOnPrimary = UIColor.black + public static var BrandBgPrimary = UIColor.lightGray + public static var BrandBgMuted = UIColor.lightGray + public static var BrandBgMuted_Border = UIColor.lightGray + + public static var SuccessTextPrimary = UIColor.green + public static var SuccessTextOnMuted = UIColor.green + public static var SuccessTextOnPrimary = UIColor.green + public static var SuccessBgPrimary = UIColor.lightGray + public static var SuccessBgMuted = UIColor.lightGray + public static var SuccessBgMuted_Border = UIColor.lightGray + + public static var DangerTextPrimary = UIColor.red + public static var DangerTextOnMuted = UIColor.red + public static var DangerTextOnPrimary = UIColor.red + public static var DangerBgPrimary = UIColor.lightGray + public static var DangerBgMuted = UIColor.lightGray + public static var DangerBgMuted_Border = UIColor.lightGray + + public static var WarningTextPrimary = UIColor.yellow + public static var WarningTextOnMuted = UIColor.yellow + public static var WarningTextOnPrimary = UIColor.yellow + public static var WarningBgPrimary = UIColor.lightGray + public static var WarningBgMuted = UIColor.lightGray + public static var WarningBgMuted_Border = UIColor.lightGray + + public static var Brand_AltTextPrimary = UIColor.black + public static var Brand_AltTextSecondary = UIColor.black + public static var Brand_AltTextOnMuted = UIColor.black + public static var Brand_AltTextOnPrimary = UIColor.black + public static var Brand_AltBgPrimary = UIColor.lightGray + public static var Brand_AltBgMuted = UIColor.lightGray + public static var Brand_AltBgDisabled = UIColor.lightGray + + public static var AttentionTextPrimary = UIColor.orange + public static var AttentionTextOnMuted = UIColor.orange + public static var AttentionTextOnPrimary = UIColor.orange + public static var AttentionBgPrimary = UIColor.lightGray + public static var AttentionBgMuted = UIColor.lightGray + public static var AttentionBgMuted_Border = UIColor.lightGray + + public static var MiscHome_Bar = UIColor.white + } + + // MARK: - Fonts + public struct Font { + + public static let MaterialDesignIconsRange = NSRange(location: 0xF001, length: 2302) + public static func MaterialDesignIconsFontName() -> String { + return "Material Design Icons" + } + public static func MaterialDesignIconsFont(size: CGFloat) -> UIFont { + return UIFont(name: MaterialDesignIconsFontName(), size: size)! + } + + public static let FamilyName = "IBM Plex Sans" + + public static let BoldName = "IBMPlexSans-Bold" + public static func Bold(size: CGFloat) -> UIFont { + return UIFont(name: BoldName, size: size)! + } + public static let ItalicBoldName = "IBMPlexSans-BoldItalic" + public static func ItalicBold(size: CGFloat) -> UIFont { + return UIFont(name: ItalicBoldName, size: size)! + } + public static let SemiBoldName = "IBMPlexSans-SmBld" + public static func SemiBold(size: CGFloat) -> UIFont { + return UIFont(name: SemiBoldName, size: size)! + } + public static let ItalicSemiBoldName = "IBMPlexSans-SmBldItalic" + public static func ItalicSemiBold(size: CGFloat) -> UIFont { + return UIFont(name: ItalicSemiBoldName, size: size)! + } + + public static let MediumName = "IBMPlexSans-Medm" + public static func Medium(size: CGFloat) -> UIFont { + return UIFont(name: MediumName, size: size)! + } + public static let RegularName = "IBMPlexSans" + public static func Regular(size: CGFloat) -> UIFont { + return UIFont(name: RegularName, size: size)! + } + + public enum Style { + + case heading1_regular + case heading1_bold + case heading1_semibold + + case heading2_regular + case heading2_bold + case heading2_semibold + + case heading3_regular + case heading3_bold + case heading3_semibold + + case heading4_regular + case heading4_bold + case heading4_semibold + + case heading5_regular + case heading5_bold + case heading5_semibold + + case heading6_regular + case heading6_bold + case heading6_semibold + + case large_regular + case large_bold + case large_semibold + case large_medium + + case base_regular + case base_bold + case base_semibold + case base_medium + + case small_regular + case small_bold + case small_semibold + case small_medium + + case xsmall_regular + case xsmall_bold + case xsmall_semibold + case xsmall_medium + } + } + + // MARK: Other + public static let ButtonCornerRadius : CGFloat = 6.0 + public static let BottomSheetCornerRadius : CGFloat = 10.0 + public static let LoadingIndicatorLineWidth : CGFloat = 3.0 + public static let LoadingIndicatorAnimationDuration : TimeInterval = 0.8 + public static var KeyboardAppearance: UIKeyboardAppearance = .default + public static var SelectedTabLineHeight: CGFloat = 4.0 +} diff --git a/BulletinSDK/Classes/Constants/Constants.swift b/BulletinSDK/Classes/Constants/Constants.swift new file mode 100644 index 0000000..74b2272 --- /dev/null +++ b/BulletinSDK/Classes/Constants/Constants.swift @@ -0,0 +1,14 @@ +// +// WZConstants.swift +// WazirX +// +// Created by Daxesh Nagar on 17/07/23. +// Copyright © 2017 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +// MARK: - +extension NSNotification.Name { + public static let AppearanceDidUpdate = NSNotification.Name("AppearanceDidUpdate") +} diff --git a/BulletinSDK/Classes/Constants/Text.swift b/BulletinSDK/Classes/Constants/Text.swift new file mode 100644 index 0000000..16d4441 --- /dev/null +++ b/BulletinSDK/Classes/Constants/Text.swift @@ -0,0 +1,17 @@ +// +// WZMessages.swift +// WazirX +// +// Created by Daxesh Nagar on 17/07/23. +// Copyright © 2017 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +public struct Text { + + // MARK: - Common Texts + public static func GotIt() -> String { return "OKay, Go it".localized() } + public static func WhatsNewInThisUpdate() -> String { return "What’s new in this update?".localized() } + +} diff --git a/BulletinSDK/Classes/Helper/BulletinHelper.swift b/BulletinSDK/Classes/Helper/BulletinHelper.swift new file mode 100644 index 0000000..90e67a2 --- /dev/null +++ b/BulletinSDK/Classes/Helper/BulletinHelper.swift @@ -0,0 +1,55 @@ +// +// BulletinHelper.swift +// Bulletin +// +// Created by Daxesh Nagar on 24/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +class BulletinHelper { } + +extension BulletinHelper { + + // MARK: - View Controller Helper Methods + public class func rootViewController(_ handler: ((_ rootVC: UIViewController?) -> Void)?) { + + if let handler = handler { + DispatchQueue.main.async { + handler(UIApplication.shared.keyWindow?.rootViewController) + } + } + } + + + public class func topMostViewController(_ handler: ((_ topMostVC: UIViewController?) -> Void)?) { + + if let handler = handler { + + DispatchQueue.main.async { + let rootVC = UIApplication.shared.keyWindow?.rootViewController + let topMostVC = BulletinHelper.topViewController(withRootViewController: rootVC) + handler(topMostVC) + } + } + } + + private class func topViewController(withRootViewController rootViewController: UIViewController?) -> UIViewController? { + + if let tabBarController = rootViewController as? UITabBarController { + return BulletinHelper.topViewController(withRootViewController: tabBarController.selectedViewController) + } + else if let navigationController = rootViewController as? UINavigationController { + return BulletinHelper.topViewController(withRootViewController: navigationController.visibleViewController) + } + else if let presentedViewController = rootViewController?.presentedViewController { + return BulletinHelper.topViewController(withRootViewController: presentedViewController) + } + else { + return rootViewController + } + } + +} + diff --git a/BulletinSDK/Classes/Helper/LocalizationHelper.swift b/BulletinSDK/Classes/Helper/LocalizationHelper.swift new file mode 100644 index 0000000..681a6e3 --- /dev/null +++ b/BulletinSDK/Classes/Helper/LocalizationHelper.swift @@ -0,0 +1,52 @@ +// +// LocalizationHelper.swift +// Bulletin +// +// Created by Daxesh Nagar on 18/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import Foundation + + +class LocalizationHelper { + + public class func string(forKey key: String) -> String { + return string(forKey: key, replaceOccurencesOfKeysWithValues: nil) + } + + public class func string(forKey key: String, + replaceOccurencesOfKeysWithValues keyValuePairs: [String:String]?) -> String + { + var localizedString = NSLocalizedString(key, tableName: "Localizable", bundle: Bundle.main, value: "", comment: "") + if localizedString == key { + localizedString = NSLocalizedString(key, comment: "") + } + + if let keyValuePairs = keyValuePairs, keyValuePairs.isEmpty == false { + for key in keyValuePairs.keys { + let keyToReplace = "~{" + key + "}" + if let replaceWithValue = keyValuePairs[key] { + localizedString = localizedString.replacingOccurrences(of: keyToReplace, with: replaceWithValue) + } + } + } + + return localizedString + } +} + + +extension String { + + // Localization Conveniance method for strings + public func localized() -> String { + return LocalizationHelper.string(forKey: self) + } + + public func localized(replaceOccurencesOfKeysWithValues keyValuePairs: [String: String]?) -> String { + return LocalizationHelper.string(forKey: self, replaceOccurencesOfKeysWithValues: keyValuePairs) + } +} + + diff --git a/BulletinSDK/Extensions/String+Class.swift b/BulletinSDK/Extensions/String+Class.swift new file mode 100644 index 0000000..e68be48 --- /dev/null +++ b/BulletinSDK/Extensions/String+Class.swift @@ -0,0 +1,36 @@ +// +// String+Class.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import Foundation + +extension String { + + // Note : This method is capable of returning any Swift or Obj-C class with its name + public static func classFromString(_ className: String?) -> AnyClass? { + + if let className = className { + + // Get Class + let _class : AnyClass? = NSClassFromString(className) + if _class == nil { + + // Check for a swift class with the same name + let bundleName = Bundle.main.object(forInfoDictionaryKey: "CFBundleExecutable") as? String + if let bundleName = bundleName { + let swiftClassName = bundleName + "." + className + return NSClassFromString(swiftClassName) + } + } + return _class + } + return nil + } + + public func classFromString() -> AnyClass? { + return String.classFromString(self) + } +} diff --git a/BulletinSDK/Extensions/String+Version.swift b/BulletinSDK/Extensions/String+Version.swift new file mode 100644 index 0000000..8ab318e --- /dev/null +++ b/BulletinSDK/Extensions/String+Version.swift @@ -0,0 +1,41 @@ +// +// String+Version.swift +// Bulletin +// +// Created by Pranav Panchal on 28/09/22. +// Copyright © 2022 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import Foundation + + +extension String { + + var isNumeric: Bool { + guard self.count > 0 else { return false } + let nums: Set = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"] + return Set(self).isSubset(of: nums) + } + + func validateVersion() -> String? { + + // Convert String In to Array + let versionBlocks = self.components(separatedBy: ".") + + // Validation + guard versionBlocks.isEmpty == false else { return nil } + + // Validation For String as Int + for versionBlock in versionBlocks { + if versionBlock.isNumeric == false { + return nil + } + } + + return versionBlocks.joined(separator: ".") + } + + func versionCompare(_ otherVersion: String) -> ComparisonResult { + return self.compare(otherVersion, options: .numeric) + } +} diff --git a/BulletinSDK/Extensions/UserDefaults+Storage.swift b/BulletinSDK/Extensions/UserDefaults+Storage.swift new file mode 100644 index 0000000..c38ae5a --- /dev/null +++ b/BulletinSDK/Extensions/UserDefaults+Storage.swift @@ -0,0 +1,37 @@ +// +// UserDefaults+Storage.swift +// Bulletin +// +// Created by Pranav Panchal on 23/09/22. +// Copyright © 2022 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import Foundation + + +extension UserDefaults { + + class var bulletin: UserDefaults { + get { + return UserDefaults(suiteName: "Bulletin")! + } + set {} + } + + class var lastSeenVersion: Version? { + get { + + // Validation + guard let versionString = bulletin.string(forKey: "BLLastSeenVersion") else { return nil } + + return Version(versionString) + } + set { + if let newValue = newValue { + bulletin.set(newValue.version, forKey: "BLLastSeenVersion") + } else { + bulletin.removeObject(forKey: "BLLastSeenVersion") + } + } + } +} diff --git a/BulletinSDK/Libraries/PopUp/AlertSegue.swift b/BulletinSDK/Libraries/PopUp/AlertSegue.swift new file mode 100644 index 0000000..2e0fb4d --- /dev/null +++ b/BulletinSDK/Libraries/PopUp/AlertSegue.swift @@ -0,0 +1,29 @@ +// +// AlertSegue.swift +// Bulletin +// +// Created by Daxesh Nagar on 24/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit +import SwiftMessages + +class AlertSegue: SwiftMessagesSegue { + + + // MARK: - Initialisation Method + override public init(identifier: String?, source: UIViewController, destination: UIViewController) { + super.init(identifier: identifier, source: source, destination: destination) + + // Override Configurations + configure(layout: .centered) + interactiveHide = false + dimMode = .color(color: UIColor.black.withAlphaComponent(0.70), interactive: true) + source.view.layoutMargins = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) + source.view.layer.cornerRadius = AppStyle.BottomSheetCornerRadius + if #available(iOS 13.0, *) { + source.view.layer.cornerCurve = .continuous + } + } +} diff --git a/BulletinSDK/Libraries/PopUp/BottomSheetSegue.swift b/BulletinSDK/Libraries/PopUp/BottomSheetSegue.swift new file mode 100644 index 0000000..9d2c052 --- /dev/null +++ b/BulletinSDK/Libraries/PopUp/BottomSheetSegue.swift @@ -0,0 +1,29 @@ +// +// BottomSheetSegue.swift +// Bulletin +// +// Created by Daxesh Nagar on 24/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit +import SwiftMessages + +class BottomSheetSegue: SwiftMessagesSegue { + + + // MARK: - Initialisation Method + override public init(identifier: String?, source: UIViewController, destination: UIViewController) { + super.init(identifier: identifier, source: source, destination: destination) + + // Override Configurations + configure(layout: .bottomTab) + interactiveHide = false + dimMode = .color(color: UIColor.black.withAlphaComponent(0.70), interactive: true) + source.view.layoutMargins = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) + source.view.layer.cornerRadius = AppStyle.BottomSheetCornerRadius + if #available(iOS 13.0, *) { + source.view.layer.cornerCurve = .continuous + } + } +} diff --git a/BulletinSDK/Libraries/PushButton/PushButton.swift b/BulletinSDK/Libraries/PushButton/PushButton.swift new file mode 100644 index 0000000..61e84a2 --- /dev/null +++ b/BulletinSDK/Libraries/PushButton/PushButton.swift @@ -0,0 +1,199 @@ +// +// PushButton.swift +// Bulletin +// +// Created by Daxesh Nagar on 21/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +open class PushButton: UIButton { + + // MARK: - Declarations + public static let PUSH_BUTTON_DEFAULT_TOUCH_DOWN_DURATION: CGFloat = 0.22 + public static let PUSH_BUTTON_DEFAULT_TOUCH_DOWN_DELAY: CGFloat = 0.0 + public static let PUSH_BUTTON_DEFAULT_TOUCH_DOWN_DAMPING: CGFloat = 0.6 + public static let PUSH_BUTTON_DEFAULT_TOUCH_DOWN_VELOCITY: CGFloat = 0.0 + public static let PUSH_BUTTON_DEFAULT_TOUCH_UP_DURATION: CGFloat = 0.7 + public static let PUSH_BUTTON_DEFAULT_TOUCH_UP_DELAY: CGFloat = 0.0 + public static let PUSH_BUTTON_DEFAULT_TOUCH_UP_DAMPING: CGFloat = 0.65 + public static let PUSH_BUTTON_DEFAULT_TOUCH_UP_VELOCITY: CGFloat = 0.0 + + + // MARK: - Variables + + // Original Transform Property + open var originalTransform = CGAffineTransform.identity { + didSet { + // Update Button Transform + transform = originalTransform + } + } + + // Set Highlight Property + @IBInspectable open var highlightStateBackgroundColor: UIColor? + + // Push Transform Property + @IBInspectable open var pushTransformScaleFactor: CGFloat = 0.8 + + // Touch Handler Blocks + open var touchDownHandler: ((_ button: PushButton) -> Void)? + open var touchUpHandler: ((_ button: PushButton) -> Void)? + + // Push Transition Animation Properties + @IBInspectable open var touchDownDuration: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_DOWN_DURATION + @IBInspectable open var touchDownDelay: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_DOWN_DELAY + @IBInspectable open var touchDownDamping: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_DOWN_DAMPING + @IBInspectable open var touchDownVelocity: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_DOWN_VELOCITY + + @IBInspectable open var touchUpDuration: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_UP_DURATION + @IBInspectable open var touchUpDelay: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_UP_DELAY + @IBInspectable open var touchUpDamping: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_UP_DAMPING + @IBInspectable open var touchUpVelocity: CGFloat = PUSH_BUTTON_DEFAULT_TOUCH_UP_VELOCITY + + // Add Extra Parameters + open var extraParam: Any? + + private var normalStateBackgroundColor: UIColor? + open override var backgroundColor: UIColor? { + didSet { + // Store Normal State Background Color + normalStateBackgroundColor = backgroundColor + } + } + + + // MARK: - Initialization Methods + public required init?(coder: NSCoder) { + super.init(coder: coder) + basicInitialisation() + } + + public override init(frame: CGRect) { + super.init(frame: frame) + basicInitialisation() + } + + open func basicInitialisation() { + + // Add Corner Curve + if #available(iOS 13.0, *) { + layer.cornerCurve = .continuous + } + + // Set Default Original Transform + originalTransform = CGAffineTransform.identity + } + + + // MARK: - Touch Events + open override func touchesBegan(_ touches: Set, with event: UIEvent?) { + super.touchesBegan(touches, with: event) + pushButton(pushButton: true, shouldAnimate: true, completion: nil) + } + + open override func touchesEnded(_ touches: Set, with event: UIEvent?) { + super.touchesEnded(touches, with: event) + pushButton(pushButton: false, shouldAnimate: true, completion: nil) + } + + open override func touchesCancelled(_ touches: Set, with event: UIEvent?) { + super.touchesCancelled(touches, with: event) + pushButton(pushButton: false, shouldAnimate: true, completion: nil) + } + + + // MARK: - Animation Method + open func pushButton(pushButton: Bool, shouldAnimate: Bool, completion: (() -> Void)?) { + + // Call Touch Events + if pushButton { + // Call Touch Down Handler + if let touchDownHandler = touchDownHandler { + touchDownHandler(self) + } + } + else { + // Call Touch Up Handler + if let touchUpHandler = touchUpHandler { + touchUpHandler(self) + } + } + + // Animation Block + let animate: (() -> Void)? = {() -> Void in + + if pushButton { + // Calculate Scale Factor For Current Frame + let scaleFactor : CGFloat = self.pushTransformScaleFactor + // Set Transform + self.transform = self.originalTransform.scaledBy(x: scaleFactor, y: scaleFactor) + // Update Background Color + if (self.highlightStateBackgroundColor != nil) { + super.backgroundColor = self.highlightStateBackgroundColor + } + } + else { + // Set Transform + self.transform = self.originalTransform + // Set Background Color + super.backgroundColor = self.normalStateBackgroundColor + } + // Layout + self.setNeedsLayout() + self.layoutIfNeeded() + } + + if shouldAnimate { + + // Configure Animation Properties + var duration: CGFloat + var delay: CGFloat + var damping: CGFloat + var velocity: CGFloat + if pushButton { + duration = touchDownDuration + delay = touchDownDelay + damping = touchDownDamping + velocity = touchDownVelocity + } + else { + duration = touchUpDuration + delay = touchUpDelay + damping = touchUpDamping + velocity = touchUpVelocity + } + + DispatchQueue.main.async { + // Animate + UIView.animate(withDuration: TimeInterval(duration), delay: TimeInterval(delay), usingSpringWithDamping: damping, initialSpringVelocity: velocity, options: [.curveEaseOut, .beginFromCurrentState, .allowUserInteraction], animations: {() -> Void in + animate!() + }, completion: {(_ finished: Bool) -> Void in + if let completion = completion, finished { + completion() + } + }) + } + } + else { + animate!() + + // Call Completion Block + if let completion = completion { + completion() + } + } + } + + + // MARK: - Dealloc + deinit { + + // Remove Touch Handlers + touchDownHandler = nil + touchUpHandler = nil + } +} + + diff --git a/BulletinSDK/Modals/BulletinInfo.swift b/BulletinSDK/Modals/BulletinInfo.swift new file mode 100644 index 0000000..d5e41ea --- /dev/null +++ b/BulletinSDK/Modals/BulletinInfo.swift @@ -0,0 +1,40 @@ +// +// BulletinInfo.swift +// Bulletin +// +// Created by Pranav Panchal on 27/09/22. +// Copyright © 2022 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit +import IGListKit + +class BulletinInfo : NSObject { + + + // MARK: - Variables + public var version: Version + public var items: [BulletinItem] + + + // MARK: - Initialisation Method + init(version: Version, items: [BulletinItem]) { + + // Set Version + self.version = version + + // Set Items + self.items = items + } +} + +extension BulletinInfo : ListDiffable { + public func diffIdentifier() -> NSObjectProtocol { + return self + } + + public func isEqual(toDiffableObject object: ListDiffable?) -> Bool { + return isEqual(object) + } +} + diff --git a/BulletinSDK/Modals/UI Modals/ActionButton.swift b/BulletinSDK/Modals/UI Modals/ActionButton.swift new file mode 100644 index 0000000..60ca6e1 --- /dev/null +++ b/BulletinSDK/Modals/UI Modals/ActionButton.swift @@ -0,0 +1,40 @@ +// +// ActionButton.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit + +class ActionButton: BulletinItem { + + + // MARK: Variables + var title: String? + var clickPayload: Any? + + + // MARK: - Initialisation Methods + override init () { + super.init() + + // Set Type + type = .actionButton + } + + + required init?(attributes: [AnyHashable: Any]) { + super.init(attributes: attributes) + + // Set Title + guard let title = attributes["title"] as? String else { + return nil + } + self.title = title + + // Set Click Payload + self.clickPayload = attributes["clickPayload"] + } +} + diff --git a/BulletinSDK/Modals/UI Modals/BulletPoint.swift b/BulletinSDK/Modals/UI Modals/BulletPoint.swift new file mode 100644 index 0000000..119c70c --- /dev/null +++ b/BulletinSDK/Modals/UI Modals/BulletPoint.swift @@ -0,0 +1,108 @@ +// +// BulletPoint.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit + +class BulletPoint: BulletinItem { + + + // MARK: Variables + var bullet: Bullet? + var titleText: String? + var subTitleText: String? + + + // MARK: - Initialisation Methods + override init () { + super.init() + + // Set Type + type = .bulletPoint + } + + required init?(attributes: [AnyHashable: Any]) { + super.init(attributes: attributes) + + // Set Bullet + guard let bulletObj = attributes["bullet"] as? [String: Any], + let bullet = Bullet(attributes: bulletObj) else { + return nil + } + self.bullet = bullet + + // Set Title Text + self.titleText = attributes["titleText"] as? String + + // Set SubTitle Text + self.subTitleText = attributes["subTitleText"] as? String + + // Validation + if titleText == nil && subTitleText == nil { + return nil + } + } +} + + + +// MARK: - Bullet +class Bullet { + + + // MARK: - Enum + enum BulletType: String { + case unicode + case image + } + + + // MARK: - Variables + var bulletType: BulletType? + var unicode: String? + var imageUrl: URL? + + + // MARK: - Initialisation Methods + init() {} + + init?(attributes: [String: Any]?) { + + + // Validation + guard let attributes = attributes else { + return nil + } + + // Set Type + guard let bulletTypeString = attributes["bulletType"] as? String, + let bulletType = BulletType(rawValue: bulletTypeString) else { + return nil + } + self.bulletType = bulletType + + switch self.bulletType { + case .unicode: + // Set Unicode + guard let unicodeString = attributes["unicode"] as? String else { + return nil + } + self.unicode = unicodeString + + case .image: + // Set ImageUrl + guard let imageUrlString = attributes["imageUrl"] as? String, + let imageUrl = URL(string: imageUrlString) else { + return nil + } + self.imageUrl = imageUrl + + case .none: + break + } + } +} + diff --git a/BulletinSDK/Modals/UI Modals/BulletinItem.swift b/BulletinSDK/Modals/UI Modals/BulletinItem.swift new file mode 100644 index 0000000..21559b2 --- /dev/null +++ b/BulletinSDK/Modals/UI Modals/BulletinItem.swift @@ -0,0 +1,63 @@ +// +// BulletinItem.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import Foundation + +class BulletinItem { + + + // MARK: - Declarations + public enum ItemType : String { + case undefined + case title + case message + case media + case bulletPoint + case actionButton + } + + + // MARK: - Variables + public var type: ItemType = .undefined + + + + // It Will Return Action Card Creatd With Proper Classes + public class func createBulletinItem(forAttributes attributes: [String: Any]?) -> BulletinItem? { + + // Validations + guard let attributes = attributes, + let typeString = attributes["type"] as? String, + let itemType = ItemType(rawValue: typeString), + itemType != .undefined else { + return nil + } + + // Get Bulletin Item + if let bulletinItem = itemType.rawValue.capitalized.classFromString() as? BulletinItem.Type { + return bulletinItem.init(attributes: attributes) + } + return nil + } + + + // MARK: - Initialisation Methods + init() {} + + required public init?(attributes: [AnyHashable: Any]) { + + // Get Item Type (create guard here) + if let itemTypeString = attributes["type"] as? String, + let type = ItemType(rawValue: itemTypeString) + { + self.type = type + } + else { + return nil + } + } +} diff --git a/BulletinSDK/Modals/UI Modals/Media.swift b/BulletinSDK/Modals/UI Modals/Media.swift new file mode 100644 index 0000000..e8a46cd --- /dev/null +++ b/BulletinSDK/Modals/UI Modals/Media.swift @@ -0,0 +1,58 @@ +// +// Media.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit + + +class Media: BulletinItem { + + + // MARK: - Enum + enum MediaType: String { + case image + } + + + // MARK: - Variables + var mediaType: MediaType = .image + var url: URL? + var size: CGSize? + + + // MARK: - Initialisation Methods + override init () { + super.init() + + // Set Type + type = .media + } + + required init?(attributes: [AnyHashable: Any]) { + super.init(attributes: attributes) + + // Set Media Type + if let mediaTypeString = attributes["mediaType"] as? String, + let mediaType = MediaType(rawValue: mediaTypeString) { + self.mediaType = mediaType + } + + // Set Url + guard let urlString = attributes["url"] as? String, + let mediaUrl = URL(string: urlString) else { + return nil + } + url = mediaUrl + + // Set Size + if let width = attributes["width"] as? CGFloat, + let height = attributes["height"] as? CGFloat + { + size = CGSize(width: width, height: height) + } + } +} + diff --git a/BulletinSDK/Modals/UI Modals/Message.swift b/BulletinSDK/Modals/UI Modals/Message.swift new file mode 100644 index 0000000..22f02d6 --- /dev/null +++ b/BulletinSDK/Modals/UI Modals/Message.swift @@ -0,0 +1,47 @@ +// +// Message.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit + + +class Message: BulletinItem { + + + // MARK: - Enum + enum MessageType: String { + case text + case html + } + + + // MARK: - Variables + var messageType: MessageType = .text + var text: String? + + + // MARK: - Initialisation Methods + override init () { + super.init() + + // Set Type + type = .message + } + + required init?(attributes: [AnyHashable: Any]) { + super.init(attributes: attributes) + + // Set Message Type + if let messasgeTypeString = attributes["messageType"] as? String, + let messageType = MessageType(rawValue: messasgeTypeString) { + self.messageType = messageType + } + + // Set Text + guard let text = attributes["text"] as? String else { return nil } + self.text = text + } +} diff --git a/BulletinSDK/Modals/UI Modals/Title.swift b/BulletinSDK/Modals/UI Modals/Title.swift new file mode 100644 index 0000000..88348e9 --- /dev/null +++ b/BulletinSDK/Modals/UI Modals/Title.swift @@ -0,0 +1,53 @@ +// +// Title.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit + +class Title: BulletinItem { + + + // MARK: - Variable + var preTitleText: String? + public var preTitleTextColor: String? + var titleText: String? + public var titleTextColor: String? + var subTitleText: String? + public var subTitleTextColor: String? + + + // MARK: - Initialisation Methods + override init () { + super.init() + + // Set Type + type = .title + } + + required init?(attributes: [AnyHashable: Any]) { + super.init(attributes: attributes) + + // Set Pre Title + preTitleText = attributes["preTitleText"] as? String + + // Set Pre Title Color + if let preTitleTextColor = attributes["preTitleTextColor"] as? String { + self.preTitleTextColor = preTitleTextColor + } + + // Set Title + titleText = attributes["titleText"] as? String + + // Set Sub Title + subTitleText = attributes["subTitleText"] as? String + + // Validations + if preTitleText == nil && titleText == nil && subTitleText == nil { + return nil + } + } +} + diff --git a/BulletinSDK/Modals/Version.swift b/BulletinSDK/Modals/Version.swift new file mode 100644 index 0000000..12ec442 --- /dev/null +++ b/BulletinSDK/Modals/Version.swift @@ -0,0 +1,67 @@ +// +// Version.swift +// Bulletin +// +// Created by Pranav Panchal on 28/09/22. +// Copyright © 2022 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import Foundation + + +struct Version { + + + // MARK: - Variable + public let version: String + + + // MARK: - Initialisation Method + init?(_ version: String) { + + // Validation + guard let version = version.validateVersion() else { return nil } + + // Set Version + self.version = version + } + +} + +extension Version: Equatable { + static func == (lhs: Version, rhs: Version) -> Bool { + return lhs.version == rhs.version + } +} + +extension Version: Comparable { + static func < (lhs: Version, rhs: Version) -> Bool { + if lhs.version.versionCompare(rhs.version) == .orderedAscending { + return true + } + return false + } + + static func <= (lhs: Version, rhs: Version) -> Bool { + let result = lhs.version.versionCompare(rhs.version) + if result == .orderedAscending || result == .orderedSame { + return true + } + return false + } + + static func > (lhs: Version, rhs: Version) -> Bool { + if lhs.version.versionCompare(rhs.version) == .orderedDescending { + return true + } + return false + } + + static func >= (lhs: Version, rhs: Version) -> Bool { + let result = lhs.version.versionCompare(rhs.version) + if result == .orderedDescending || result == .orderedSame { + return true + } + return false + } +} diff --git a/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Bold.ttf b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Bold.ttf new file mode 100644 index 0000000..72b190a Binary files /dev/null and b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Bold.ttf differ diff --git a/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-BoldItalic.ttf b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-BoldItalic.ttf new file mode 100644 index 0000000..75c2959 Binary files /dev/null and b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-BoldItalic.ttf differ diff --git a/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Medium.ttf b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Medium.ttf new file mode 100644 index 0000000..c80d08a Binary files /dev/null and b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Medium.ttf differ diff --git a/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Regular.ttf b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Regular.ttf new file mode 100644 index 0000000..9e4b0a7 Binary files /dev/null and b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-Regular.ttf differ diff --git a/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-SemiBold.ttf b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-SemiBold.ttf new file mode 100644 index 0000000..0dd7347 Binary files /dev/null and b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-SemiBold.ttf differ diff --git a/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-SemiBoldItalic.ttf b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-SemiBoldItalic.ttf new file mode 100644 index 0000000..ed53cae Binary files /dev/null and b/BulletinSDK/Resources/Fonts/IBMPlexSans/IBMPlexSans-SemiBoldItalic.ttf differ diff --git a/BulletinSDK/View/ActionButton/ActionButtonViewCell.swift b/BulletinSDK/View/ActionButton/ActionButtonViewCell.swift new file mode 100644 index 0000000..880028b --- /dev/null +++ b/BulletinSDK/View/ActionButton/ActionButtonViewCell.swift @@ -0,0 +1,87 @@ +// +// ActionButtonViewCell.swift +// Bulletin +// +// Created by Daxesh Nagar on 20/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +protocol ActionButtonViewCellDelegate: AnyObject { + func actionButtonViewCell(_ cell: ActionButtonViewCell, ofItem item: BulletinItem) +} + +class ActionButtonViewCell: BaseCollectionViewCell { + + // MARK: - Variables + @IBOutlet private var actionButton: PushButton! + + public weak var delegate: ActionButtonViewCellDelegate? + + public var item: ActionButton? { + didSet { + updateUI() + } + } + + override var intrinsicContentSize: CGSize { + let size = contentView.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize) + return CGSize(width: UIView.noIntrinsicMetric, height: size.height) + } + + // MARK: - Initialisation Methods + override func awakeFromNib() { + super.awakeFromNib() + + // Action Button + actionButton.layer.cornerRadius = AppStyle.ButtonCornerRadius + } + + override func updateAppearance() { + super.updateAppearance() + + // Set BackgroundColor + backgroundColor = AppStyle.Color.MainBgSurface_Alt + + // Set Action Button Container View + actionButton.setTitleColor(AppStyle.Color.BrandTextPrimary, for: .normal) + actionButton.titleLabel?.base_semibold() + actionButton.layer.borderWidth = 1.0 + actionButton.layer.borderColor = AppStyle.Color.BrandBgPrimary.cgColor + + } + + //MARK: - Helper Methods + private func updateUI() { + + // Validation + guard let actionButtonItem = item else { + + // Reset To Nil + actionButton = nil + + return + } + + + // Open Gift Button + if let actionButtonTitle = actionButtonItem.title { + actionButton.setTitle(actionButtonTitle.uppercased(), for: .normal) + } + + // Layout Cell + setNeedsLayout() + layoutIfNeeded() + } + + @IBAction func actionButtonTapped(_ sender: Any) { + + // Validation + guard let item = item else { return } + + // Call Delegate + delegate?.actionButtonViewCell(self, ofItem: item) + } +} + diff --git a/BulletinSDK/View/ActionButton/ActionButtonViewCell.xib b/BulletinSDK/View/ActionButton/ActionButtonViewCell.xib new file mode 100644 index 0000000..3a2353b --- /dev/null +++ b/BulletinSDK/View/ActionButton/ActionButtonViewCell.xib @@ -0,0 +1,60 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/BulletinSDK/View/BulletPoint/BulletPointViewCell.swift b/BulletinSDK/View/BulletPoint/BulletPointViewCell.swift new file mode 100644 index 0000000..728b1b7 --- /dev/null +++ b/BulletinSDK/View/BulletPoint/BulletPointViewCell.swift @@ -0,0 +1,136 @@ +// +// BulletPointViewCell.swift +// Bulletin +// +// Created by Daxesh Nagar on 20/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +protocol BulletPointViewCellDelegate: AnyObject { + func bulletPointViewCell(_ cell: BulletPointViewCell, ofItem item: BulletinItem) +} + +class BulletPointViewCell: BaseCollectionViewCell { + + // MARK: - Variables + @IBOutlet private var bulletTitle: UILabel! + @IBOutlet private var bulletDesc: UILabel! + @IBOutlet private var bulletName: UILabel! + @IBOutlet private var bulletImageView: UIImageView! + + public weak var delegate: BulletPointViewCellDelegate? + + public var item: BulletPoint? { + didSet { + updateUI() + } + } + + override var intrinsicContentSize: CGSize { + let size = contentView.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize) + return CGSize(width: UIView.noIntrinsicMetric, height: size.height) + } + + // MARK: - Initialisation Methods + override func awakeFromNib() { + super.awakeFromNib() + // Initialization code + } + + override func updateAppearance() { + super.updateAppearance() + + // Set Background Color + backgroundColor = AppStyle.Color.MainBgSurface_Alt + + // Set preTitle Label + bulletTitle.large_semibold() + bulletTitle.textColor = AppStyle.Color.MainTextPrimary + + // Set Title Label + bulletDesc.base_regular() + bulletDesc.textColor = AppStyle.Color.MainTextSecondary + } + + //MARK: - Helper Methods + private func updateUI() { + + // Reset To Nil + bulletImageView.kf.cancelDownloadTask() + bulletImageView.image = nil + + // Validation + guard let bulletPointItem = item else { + + // Reset To Nil + bulletTitle = nil + bulletDesc = nil + bulletImageView = nil + bulletName = nil + + return + } + + switch (bulletPointItem.bullet?.bulletType) { + + case .unicode: + + // Set Unicode Icon + if let bulletUnicode = bulletPointItem.bullet?.unicode?.unicodeString { + bulletName.text = bulletUnicode + } + + case .image: + + // Set Image Icon + if let iconUrl = bulletPointItem.bullet?.imageUrl { + bulletImageView.kf.setImage(with: iconUrl) { [weak self] (result) in + switch result { + case .success(let value): + + // Image downloaded + if let weakSelf = self, + let sourceUrl = value.source.url, + sourceUrl == iconUrl { + weakSelf.bulletImageView.image = value.image + weakSelf.bulletImageView.isHidden = false + } + case .failure(let error): + print("\(error.localizedDescription)") + } + } + } else { + bulletImageView.image = nil + bulletImageView.isHidden = true + } + + case .none: + bulletImageView.isHidden = true + bulletName.isHidden = true + } + + // Set Bullet Title + if let title = bulletPointItem.titleText,title.isEmpty == false { + bulletTitle.isHidden = false + bulletTitle.text = title + } else { + bulletTitle.isHidden = true + } + + // Set Bullet Desc + if let subTitle = bulletPointItem.subTitleText { + bulletDesc.isHidden = false + bulletDesc.text = subTitle + } else { + bulletDesc.isHidden = true + } + + // Layout Cell + setNeedsLayout() + layoutIfNeeded() + } + +} + diff --git a/BulletinSDK/View/BulletPoint/BulletPointViewCell.xib b/BulletinSDK/View/BulletPoint/BulletPointViewCell.xib new file mode 100644 index 0000000..709beb8 --- /dev/null +++ b/BulletinSDK/View/BulletPoint/BulletPointViewCell.xib @@ -0,0 +1,100 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/BulletinSDK/View/Media/MediaViewCell.swift b/BulletinSDK/View/Media/MediaViewCell.swift new file mode 100644 index 0000000..e191758 --- /dev/null +++ b/BulletinSDK/View/Media/MediaViewCell.swift @@ -0,0 +1,101 @@ +// +// MediaViewCell.swift +// Bulletin +// +// Created by Daxesh Nagar on 20/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit +import Kingfisher + +protocol MediaViewCellDelegate: AnyObject { + func mediaViewCell(_ cell: MediaViewCell, ofItem item: BulletinItem) +} + +class MediaViewCell: BaseCollectionViewCell { + + // MARK: - Variables + @IBOutlet private weak var containerStackView: UIStackView! + @IBOutlet private weak var mediaImageView: UIImageView! + @IBOutlet private weak var imageViewHeightConstraint: NSLayoutConstraint! + + public weak var delegate: MediaViewCellDelegate? + + public var item: Media? { + didSet { + self.updateUI() + } + } + + override var intrinsicContentSize: CGSize { + let size = contentView.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize) + return CGSize(width: UIView.noIntrinsicMetric, height: size.height) + } + + + // MARK: - Initialisation Methods + override func awakeFromNib() { + super.awakeFromNib() + // Initialization code + } + + override func layoutSubviews() { + super.layoutSubviews() + + // Setting Frame Of Inside Container SubView Of Cell + if let item = item, + let itemSize = item.size { + let height : CGFloat = ((contentView.frame.width - containerStackView.layoutMargins.left - containerStackView.layoutMargins.right) * itemSize.height) / itemSize.width + imageViewHeightConstraint.constant = height + } else { + imageViewHeightConstraint.constant = 135 + } + } + + //MARK: - Helper Methods + private func updateUI() { + + // Reset To Nil + mediaImageView.kf.cancelDownloadTask() + mediaImageView.image = nil + + // Validation + guard let mediaItem = item else { + return + } + + // Set Image + if let iconUrl = mediaItem.url { + mediaImageView.kf.setImage(with: iconUrl) { [weak self] (result) in + switch result { + case .success(let value): + + // Image downloaded + if let weakSelf = self, + let sourceUrl = value.source.url, + sourceUrl == iconUrl { + weakSelf.mediaImageView.image = value.image + weakSelf.mediaImageView.isHidden = false + } + case .failure(let error): + print("\(error.localizedDescription)") + } + } + } else { + mediaImageView.isHidden = true + } + + // Layout Cell + layoutIfNeeded() + + } + + override func updateAppearance() { + super.updateAppearance() + + // Set Background Color + backgroundColor = AppStyle.Color.MainBgSurface_Alt + } + +} diff --git a/BulletinSDK/View/Media/MediaViewCell.xib b/BulletinSDK/View/Media/MediaViewCell.xib new file mode 100644 index 0000000..b1c38f2 --- /dev/null +++ b/BulletinSDK/View/Media/MediaViewCell.xib @@ -0,0 +1,50 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/BulletinSDK/View/Message/MessageViewCell.swift b/BulletinSDK/View/Message/MessageViewCell.swift new file mode 100644 index 0000000..a78c9eb --- /dev/null +++ b/BulletinSDK/View/Message/MessageViewCell.swift @@ -0,0 +1,95 @@ +// +// MessageViewCell.swift +// Bulletin +// +// Created by Daxesh Nagar on 20/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +protocol MessageViewCellDelegate: AnyObject { + func messageViewCell(_ cell: MessageViewCell, ofItem item: BulletinItem) +} + +class MessageViewCell: BaseCollectionViewCell { + + // MARK: - Variables + @IBOutlet private var descMsgLabel: UILabel! + + public weak var delegate: MessageViewCellDelegate? + + public var item: Message? { + didSet { + updateUI() + } + } + + override var intrinsicContentSize: CGSize { + let size = contentView.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize) + return CGSize(width: UIView.noIntrinsicMetric, height: size.height) + } + + // MARK: - Initialisation Methods + override func awakeFromNib() { + super.awakeFromNib() + // Initialization code + } + + override func updateAppearance() { + super.updateAppearance() + + // Set Background Color + backgroundColor = AppStyle.Color.MainBgSurface_Alt + + // Set Description Label + descMsgLabel.base_regular() + descMsgLabel.textColor = AppStyle.Color.MainTextPrimary + + } + + //MARK: - Helper Methods + private func updateUI() { + + // Validation + guard let messageItem = item else { + + // Reset To Nil + descMsgLabel.text = nil + + return + } + + switch (messageItem.messageType) { + + case .html: + + // Set Html Description Message + if let descMessage = messageItem.text, + descMessage.isEmpty == false, + let htmlAttributedString = descMessage.html2AttributedString(usingFont: AppStyle.Font.Medium(size: 12), color: AppStyle.Color.MainTextPrimary)?.trailingNewlineChopped + { + descMsgLabel.attributedText = htmlAttributedString + descMsgLabel.isHidden = false + } else { + descMsgLabel.isHidden = true + } + + case .text: + + // Set Description Message + if let descMessage = messageItem.text,descMessage.isEmpty == false { + descMsgLabel.text = descMessage + descMsgLabel.isHidden = false + } else { + descMsgLabel.isHidden = true + } + + } + + // Layout Cell + setNeedsLayout() + layoutIfNeeded() + } + +} diff --git a/BulletinSDK/View/Message/MessageViewCell.xib b/BulletinSDK/View/Message/MessageViewCell.xib new file mode 100644 index 0000000..bb0c0b3 --- /dev/null +++ b/BulletinSDK/View/Message/MessageViewCell.xib @@ -0,0 +1,48 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/BulletinSDK/View/Title/TitleViewCell.swift b/BulletinSDK/View/Title/TitleViewCell.swift new file mode 100644 index 0000000..4d6f308 --- /dev/null +++ b/BulletinSDK/View/Title/TitleViewCell.swift @@ -0,0 +1,109 @@ +// +// TitleViewCell.swift +// Bulletin +// +// Created by Daxesh Nagar on 20/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit + +protocol TitleViewCellDelegate: AnyObject { + func titleViewCell(_ cell: TitleViewCell, ofItem item: BulletinItem) +} + +class TitleViewCell: BaseCollectionViewCell { + + // MARK: - Variables + @IBOutlet private var preTitleLabel: UILabel! + @IBOutlet private var titleLabel: UILabel! + @IBOutlet private var subTitleLabel: UILabel! + + public weak var delegate: TitleViewCellDelegate? + + public var item: Title? { + didSet { + updateUI() + } + } + + override var intrinsicContentSize: CGSize { + let size = contentView.systemLayoutSizeFitting(UIView.layoutFittingCompressedSize) + return CGSize(width: UIView.noIntrinsicMetric, height: size.height) + } + + // MARK: - Initialisation Methods + override func awakeFromNib() { + super.awakeFromNib() + // Initialization code + } + + override func loadVariables() { + super.loadVariables() + + } + + override func updateAppearance() { + super.updateAppearance() + + // Set Background Color + backgroundColor = AppStyle.Color.MainBgSurface_Alt + + // Set preTitle Label + preTitleLabel.small_medium() + preTitleLabel.textColor = AppStyle.Color.SuccessTextPrimary + + // Set Title Label + titleLabel.heading4_semibold() + titleLabel.textColor = AppStyle.Color.MainTextPrimary + + // Set subTitle Label + subTitleLabel.base_regular() + subTitleLabel.textColor = AppStyle.Color.MainTextPrimary + + } + + //MARK: - Helper Methods + private func updateUI() { + + // Validation + guard let titleItem = item else { + + // Reset To Nil + preTitleLabel.text = nil + titleLabel.text = nil + subTitleLabel.text = nil + return + } + + // Set Version Number + if let preTitle = titleItem.preTitleText,preTitle.isEmpty == false { + preTitleLabel.text = preTitle + preTitleLabel.isHidden = false + } else { + preTitleLabel.isHidden = true + } + + // Set Version Title + if let title = titleItem.titleText,title.isEmpty == false { + titleLabel.text = title + titleLabel.isHidden = false + } else { + titleLabel.isHidden = true + } + + // Set Version SubTitle + if let subTitle = titleItem.subTitleText,subTitle.isEmpty == false { + subTitleLabel.text = subTitle + subTitleLabel.isHidden = false + } else { + subTitleLabel.isHidden = true + } + + // Layout Cell + setNeedsLayout() + layoutIfNeeded() + } + +} + diff --git a/BulletinSDK/View/Title/TitleViewCell.xib b/BulletinSDK/View/Title/TitleViewCell.xib new file mode 100644 index 0000000..a0e3aa4 --- /dev/null +++ b/BulletinSDK/View/Title/TitleViewCell.xib @@ -0,0 +1,67 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Bulletin.xcodeproj/project.pbxproj b/Demo/Bulletin.xcodeproj/project.pbxproj new file mode 100644 index 0000000..36aa0fe --- /dev/null +++ b/Demo/Bulletin.xcodeproj/project.pbxproj @@ -0,0 +1,806 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 56; + objects = { + +/* Begin PBXBuildFile section */ + 7315D8492A696EFC00B7CE4F /* BulletPointViewCell.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7315D8472A696EFC00B7CE4F /* BulletPointViewCell.swift */; }; + 7315D84A2A696EFC00B7CE4F /* BulletPointViewCell.xib in Resources */ = {isa = PBXBuildFile; fileRef = 7315D8482A696EFC00B7CE4F /* BulletPointViewCell.xib */; }; + 7315D84D2A696F4300B7CE4F /* ActionButtonViewCell.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7315D84B2A696F4300B7CE4F /* ActionButtonViewCell.swift */; }; + 7315D84E2A696F4300B7CE4F /* ActionButtonViewCell.xib in Resources */ = {isa = PBXBuildFile; fileRef = 7315D84C2A696F4300B7CE4F /* ActionButtonViewCell.xib */; }; + 7315D8512A696FA100B7CE4F /* MessageViewCell.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7315D84F2A696FA100B7CE4F /* MessageViewCell.swift */; }; + 7315D8522A696FA100B7CE4F /* MessageViewCell.xib in Resources */ = {isa = PBXBuildFile; fileRef = 7315D8502A696FA100B7CE4F /* MessageViewCell.xib */; }; + 7315D8552A696FE400B7CE4F /* MediaViewCell.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7315D8532A696FE400B7CE4F /* MediaViewCell.swift */; }; + 7315D8562A696FE400B7CE4F /* MediaViewCell.xib in Resources */ = {isa = PBXBuildFile; fileRef = 7315D8542A696FE400B7CE4F /* MediaViewCell.xib */; }; + 7315D8592A69703700B7CE4F /* TitleViewCell.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7315D8572A69703700B7CE4F /* TitleViewCell.swift */; }; + 7315D85A2A69703700B7CE4F /* TitleViewCell.xib in Resources */ = {isa = PBXBuildFile; fileRef = 7315D8582A69703700B7CE4F /* TitleViewCell.xib */; }; + 732D1C2E2A66BAEA00FB5BFE /* LocalizationHelper.swift in Sources */ = {isa = PBXBuildFile; fileRef = 732D1C2D2A66BAEA00FB5BFE /* LocalizationHelper.swift */; }; + 732D1C312A66C6F500FB5BFE /* UILabel+FontStyle.swift in Sources */ = {isa = PBXBuildFile; fileRef = 732D1C302A66C6F500FB5BFE /* UILabel+FontStyle.swift */; }; + 738B01F02A6819C900CFDB09 /* BulletinListSectionController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 738B01EF2A6819C900CFDB09 /* BulletinListSectionController.swift */; }; + 73B17D602A6649240085EB1A /* Constants.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73B17D5D2A6649240085EB1A /* Constants.swift */; }; + 73B17D612A6649240085EB1A /* Text.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73B17D5E2A6649240085EB1A /* Text.swift */; }; + 73B17D622A6649240085EB1A /* Appearance.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73B17D5F2A6649240085EB1A /* Appearance.swift */; }; + 73CC10192A650D1600BB08C5 /* BaseCollectionViewCell.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73CC10182A650D1600BB08C5 /* BaseCollectionViewCell.swift */; }; + 73D8C8412A715A6400652504 /* String+Unicode.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73D8C8402A715A6400652504 /* String+Unicode.swift */; }; + 73D8C8432A7164C700652504 /* UIView+SubviewAspectSize.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73D8C8422A7164C700652504 /* UIView+SubviewAspectSize.swift */; }; + 73E28D922A77E0DE002F73B3 /* BulletinListVC.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73E28D902A77E0DE002F73B3 /* BulletinListVC.swift */; }; + 73E28D932A77E0DE002F73B3 /* BulletinListVC.xib in Resources */ = {isa = PBXBuildFile; fileRef = 73E28D912A77E0DE002F73B3 /* BulletinListVC.xib */; }; + 73E824F92A6A4F72007AA8D7 /* String+HTML.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73E824F82A6A4F72007AA8D7 /* String+HTML.swift */; }; + 73E824FB2A6A51AD007AA8D7 /* NSAttributedString+Utility.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73E824FA2A6A51AD007AA8D7 /* NSAttributedString+Utility.swift */; }; + 73E824FF2A6A67F5007AA8D7 /* PushButton.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73E824FE2A6A67F5007AA8D7 /* PushButton.swift */; }; + 73F62F782A6E2CF0007CBC36 /* BottomSheetSegue.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73F62F772A6E2CF0007CBC36 /* BottomSheetSegue.swift */; }; + 73F62F7A2A6E2D0E007CBC36 /* AlertSegue.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73F62F792A6E2D0E007CBC36 /* AlertSegue.swift */; }; + 73F62F7C2A6E4D79007CBC36 /* BulletinHelper.swift in Sources */ = {isa = PBXBuildFile; fileRef = 73F62F7B2A6E4D79007CBC36 /* BulletinHelper.swift */; }; + 73F62F882A6E90B1007CBC36 /* IBMPlexSans-Regular.ttf in Resources */ = {isa = PBXBuildFile; fileRef = 73F62F822A6E90B1007CBC36 /* IBMPlexSans-Regular.ttf */; }; + 73F62F892A6E90B1007CBC36 /* IBMPlexSans-SemiBold.ttf in Resources */ = {isa = PBXBuildFile; fileRef = 73F62F832A6E90B1007CBC36 /* IBMPlexSans-SemiBold.ttf */; }; + 73F62F8A2A6E90B1007CBC36 /* IBMPlexSans-SemiBoldItalic.ttf in Resources */ = {isa = PBXBuildFile; fileRef = 73F62F842A6E90B1007CBC36 /* IBMPlexSans-SemiBoldItalic.ttf */; }; + 73F62F8B2A6E90B1007CBC36 /* IBMPlexSans-Medium.ttf in Resources */ = {isa = PBXBuildFile; fileRef = 73F62F852A6E90B1007CBC36 /* IBMPlexSans-Medium.ttf */; }; + 73F62F8C2A6E90B1007CBC36 /* IBMPlexSans-Bold.ttf in Resources */ = {isa = PBXBuildFile; fileRef = 73F62F862A6E90B1007CBC36 /* IBMPlexSans-Bold.ttf */; }; + 73F62F8D2A6E90B1007CBC36 /* IBMPlexSans-BoldItalic.ttf in Resources */ = {isa = PBXBuildFile; fileRef = 73F62F872A6E90B1007CBC36 /* IBMPlexSans-BoldItalic.ttf */; }; + 815E3D7928DC85510042CEA5 /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3D7828DC85510042CEA5 /* AppDelegate.swift */; }; + 815E3D7B28DC85510042CEA5 /* SceneDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3D7A28DC85510042CEA5 /* SceneDelegate.swift */; }; + 815E3D7D28DC85510042CEA5 /* ViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3D7C28DC85510042CEA5 /* ViewController.swift */; }; + 815E3D8028DC85510042CEA5 /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 815E3D7E28DC85510042CEA5 /* Main.storyboard */; }; + 815E3D8228DC85510042CEA5 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 815E3D8128DC85510042CEA5 /* Assets.xcassets */; }; + 815E3D8528DC85510042CEA5 /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 815E3D8328DC85510042CEA5 /* LaunchScreen.storyboard */; }; + 815E3DB228DC884C0042CEA5 /* String+Class.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DA728DC884C0042CEA5 /* String+Class.swift */; }; + 815E3DB328DC884C0042CEA5 /* BulletinDataStore.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DA828DC884C0042CEA5 /* BulletinDataStore.swift */; }; + 815E3DB428DC884C0042CEA5 /* BulletinItem.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DAA28DC884C0042CEA5 /* BulletinItem.swift */; }; + 815E3DB628DC884C0042CEA5 /* Message.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DAC28DC884C0042CEA5 /* Message.swift */; }; + 815E3DB728DC884C0042CEA5 /* BulletPoint.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DAD28DC884C0042CEA5 /* BulletPoint.swift */; }; + 815E3DB828DC884C0042CEA5 /* Title.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DAE28DC884C0042CEA5 /* Title.swift */; }; + 815E3DB928DC884C0042CEA5 /* Media.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DAF28DC884C0042CEA5 /* Media.swift */; }; + 815E3DBA28DC884C0042CEA5 /* ActionButton.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DB028DC884C0042CEA5 /* ActionButton.swift */; }; + 815E3DBB28DC884C0042CEA5 /* BulletinSDK.swift in Sources */ = {isa = PBXBuildFile; fileRef = 815E3DB128DC884C0042CEA5 /* BulletinSDK.swift */; }; + 819772DC28E2CBEF00962913 /* BulletinInfo.swift in Sources */ = {isa = PBXBuildFile; fileRef = 819772DB28E2CBEF00962913 /* BulletinInfo.swift */; }; + 819772DE28E40B8100962913 /* Version.swift in Sources */ = {isa = PBXBuildFile; fileRef = 819772DD28E40B8100962913 /* Version.swift */; }; + 819772E028E40C4800962913 /* String+Version.swift in Sources */ = {isa = PBXBuildFile; fileRef = 819772DF28E40C4800962913 /* String+Version.swift */; }; + 81E010E228DDA2D9003FFE79 /* UserDefaults+Storage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 81E010E128DDA2D9003FFE79 /* UserDefaults+Storage.swift */; }; + 84A09C653687F3E6C276EB35 /* Pods_Bulletin.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = C06C8F2A28D17F9F6D3D37D2 /* Pods_Bulletin.framework */; }; +/* End PBXBuildFile section */ + +/* Begin PBXFileReference section */ + 3D5C61AE690BD66E176DA0F5 /* Pods-Bulletin.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; name = "Pods-Bulletin.release.xcconfig"; path = "Target Support Files/Pods-Bulletin/Pods-Bulletin.release.xcconfig"; sourceTree = ""; }; + 7315D8472A696EFC00B7CE4F /* BulletPointViewCell.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BulletPointViewCell.swift; sourceTree = ""; }; + 7315D8482A696EFC00B7CE4F /* BulletPointViewCell.xib */ = {isa = PBXFileReference; lastKnownFileType = file.xib; path = BulletPointViewCell.xib; sourceTree = ""; }; + 7315D84B2A696F4300B7CE4F /* ActionButtonViewCell.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ActionButtonViewCell.swift; sourceTree = ""; }; + 7315D84C2A696F4300B7CE4F /* ActionButtonViewCell.xib */ = {isa = PBXFileReference; lastKnownFileType = file.xib; path = ActionButtonViewCell.xib; sourceTree = ""; }; + 7315D84F2A696FA100B7CE4F /* MessageViewCell.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MessageViewCell.swift; sourceTree = ""; }; + 7315D8502A696FA100B7CE4F /* MessageViewCell.xib */ = {isa = PBXFileReference; lastKnownFileType = file.xib; path = MessageViewCell.xib; sourceTree = ""; }; + 7315D8532A696FE400B7CE4F /* MediaViewCell.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MediaViewCell.swift; sourceTree = ""; }; + 7315D8542A696FE400B7CE4F /* MediaViewCell.xib */ = {isa = PBXFileReference; lastKnownFileType = file.xib; path = MediaViewCell.xib; sourceTree = ""; }; + 7315D8572A69703700B7CE4F /* TitleViewCell.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TitleViewCell.swift; sourceTree = ""; }; + 7315D8582A69703700B7CE4F /* TitleViewCell.xib */ = {isa = PBXFileReference; lastKnownFileType = file.xib; path = TitleViewCell.xib; sourceTree = ""; }; + 732D1C2D2A66BAEA00FB5BFE /* LocalizationHelper.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LocalizationHelper.swift; sourceTree = ""; }; + 732D1C302A66C6F500FB5BFE /* UILabel+FontStyle.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "UILabel+FontStyle.swift"; sourceTree = ""; }; + 738B01EF2A6819C900CFDB09 /* BulletinListSectionController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BulletinListSectionController.swift; sourceTree = ""; }; + 73B17D5D2A6649240085EB1A /* Constants.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Constants.swift; sourceTree = ""; }; + 73B17D5E2A6649240085EB1A /* Text.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Text.swift; sourceTree = ""; }; + 73B17D5F2A6649240085EB1A /* Appearance.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Appearance.swift; sourceTree = ""; }; + 73CC10182A650D1600BB08C5 /* BaseCollectionViewCell.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BaseCollectionViewCell.swift; sourceTree = ""; }; + 73D8C8402A715A6400652504 /* String+Unicode.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "String+Unicode.swift"; sourceTree = ""; }; + 73D8C8422A7164C700652504 /* UIView+SubviewAspectSize.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "UIView+SubviewAspectSize.swift"; sourceTree = ""; }; + 73E28D902A77E0DE002F73B3 /* BulletinListVC.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BulletinListVC.swift; sourceTree = ""; }; + 73E28D912A77E0DE002F73B3 /* BulletinListVC.xib */ = {isa = PBXFileReference; lastKnownFileType = file.xib; path = BulletinListVC.xib; sourceTree = ""; }; + 73E824F82A6A4F72007AA8D7 /* String+HTML.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "String+HTML.swift"; sourceTree = ""; }; + 73E824FA2A6A51AD007AA8D7 /* NSAttributedString+Utility.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "NSAttributedString+Utility.swift"; sourceTree = ""; }; + 73E824FE2A6A67F5007AA8D7 /* PushButton.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PushButton.swift; sourceTree = ""; }; + 73F62F772A6E2CF0007CBC36 /* BottomSheetSegue.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BottomSheetSegue.swift; sourceTree = ""; }; + 73F62F792A6E2D0E007CBC36 /* AlertSegue.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlertSegue.swift; sourceTree = ""; }; + 73F62F7B2A6E4D79007CBC36 /* BulletinHelper.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BulletinHelper.swift; sourceTree = ""; }; + 73F62F822A6E90B1007CBC36 /* IBMPlexSans-Regular.ttf */ = {isa = PBXFileReference; lastKnownFileType = file; path = "IBMPlexSans-Regular.ttf"; sourceTree = ""; }; + 73F62F832A6E90B1007CBC36 /* IBMPlexSans-SemiBold.ttf */ = {isa = PBXFileReference; lastKnownFileType = file; path = "IBMPlexSans-SemiBold.ttf"; sourceTree = ""; }; + 73F62F842A6E90B1007CBC36 /* IBMPlexSans-SemiBoldItalic.ttf */ = {isa = PBXFileReference; lastKnownFileType = file; path = "IBMPlexSans-SemiBoldItalic.ttf"; sourceTree = ""; }; + 73F62F852A6E90B1007CBC36 /* IBMPlexSans-Medium.ttf */ = {isa = PBXFileReference; lastKnownFileType = file; path = "IBMPlexSans-Medium.ttf"; sourceTree = ""; }; + 73F62F862A6E90B1007CBC36 /* IBMPlexSans-Bold.ttf */ = {isa = PBXFileReference; lastKnownFileType = file; path = "IBMPlexSans-Bold.ttf"; sourceTree = ""; }; + 73F62F872A6E90B1007CBC36 /* IBMPlexSans-BoldItalic.ttf */ = {isa = PBXFileReference; lastKnownFileType = file; path = "IBMPlexSans-BoldItalic.ttf"; sourceTree = ""; }; + 815E3D7528DC85510042CEA5 /* Bulletin.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = Bulletin.app; sourceTree = BUILT_PRODUCTS_DIR; }; + 815E3D7828DC85510042CEA5 /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = ""; }; + 815E3D7A28DC85510042CEA5 /* SceneDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SceneDelegate.swift; sourceTree = ""; }; + 815E3D7C28DC85510042CEA5 /* ViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ViewController.swift; sourceTree = ""; }; + 815E3D7F28DC85510042CEA5 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = ""; }; + 815E3D8128DC85510042CEA5 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = ""; }; + 815E3D8428DC85510042CEA5 /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = ""; }; + 815E3D8628DC85510042CEA5 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; + 815E3DA728DC884C0042CEA5 /* String+Class.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = "String+Class.swift"; sourceTree = ""; }; + 815E3DA828DC884C0042CEA5 /* BulletinDataStore.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BulletinDataStore.swift; sourceTree = ""; }; + 815E3DAA28DC884C0042CEA5 /* BulletinItem.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BulletinItem.swift; sourceTree = ""; }; + 815E3DAC28DC884C0042CEA5 /* Message.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Message.swift; sourceTree = ""; }; + 815E3DAD28DC884C0042CEA5 /* BulletPoint.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BulletPoint.swift; sourceTree = ""; }; + 815E3DAE28DC884C0042CEA5 /* Title.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Title.swift; sourceTree = ""; }; + 815E3DAF28DC884C0042CEA5 /* Media.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = Media.swift; sourceTree = ""; }; + 815E3DB028DC884C0042CEA5 /* ActionButton.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = ActionButton.swift; sourceTree = ""; }; + 815E3DB128DC884C0042CEA5 /* BulletinSDK.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BulletinSDK.swift; sourceTree = ""; }; + 819772DB28E2CBEF00962913 /* BulletinInfo.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BulletinInfo.swift; sourceTree = ""; }; + 819772DD28E40B8100962913 /* Version.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = Version.swift; sourceTree = ""; }; + 819772DF28E40C4800962913 /* String+Version.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "String+Version.swift"; sourceTree = ""; }; + 81E010E128DDA2D9003FFE79 /* UserDefaults+Storage.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = "UserDefaults+Storage.swift"; sourceTree = ""; }; + C06C8F2A28D17F9F6D3D37D2 /* Pods_Bulletin.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = Pods_Bulletin.framework; sourceTree = BUILT_PRODUCTS_DIR; }; + F5FFA406F95FB2E07D3D917C /* Pods-Bulletin.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; name = "Pods-Bulletin.debug.xcconfig"; path = "Target Support Files/Pods-Bulletin/Pods-Bulletin.debug.xcconfig"; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 815E3D7228DC85510042CEA5 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + 84A09C653687F3E6C276EB35 /* Pods_Bulletin.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 4BE0D836F189FD1FC7E5D668 /* Pods */ = { + isa = PBXGroup; + children = ( + F5FFA406F95FB2E07D3D917C /* Pods-Bulletin.debug.xcconfig */, + 3D5C61AE690BD66E176DA0F5 /* Pods-Bulletin.release.xcconfig */, + ); + path = Pods; + sourceTree = ""; + }; + 6BB9BBCB1B81AA5BB2878A15 /* Frameworks */ = { + isa = PBXGroup; + children = ( + C06C8F2A28D17F9F6D3D37D2 /* Pods_Bulletin.framework */, + ); + name = Frameworks; + sourceTree = ""; + }; + 7315D82F2A68E7F100B7CE4F /* Media */ = { + isa = PBXGroup; + children = ( + 7315D8532A696FE400B7CE4F /* MediaViewCell.swift */, + 7315D8542A696FE400B7CE4F /* MediaViewCell.xib */, + ); + path = Media; + sourceTree = ""; + }; + 7315D8342A68E81D00B7CE4F /* Message */ = { + isa = PBXGroup; + children = ( + 7315D84F2A696FA100B7CE4F /* MessageViewCell.swift */, + 7315D8502A696FA100B7CE4F /* MessageViewCell.xib */, + ); + path = Message; + sourceTree = ""; + }; + 7315D83D2A68E88A00B7CE4F /* ActionButton */ = { + isa = PBXGroup; + children = ( + 7315D84B2A696F4300B7CE4F /* ActionButtonViewCell.swift */, + 7315D84C2A696F4300B7CE4F /* ActionButtonViewCell.xib */, + ); + path = ActionButton; + sourceTree = ""; + }; + 7315D8422A68E8A800B7CE4F /* BulletPoint */ = { + isa = PBXGroup; + children = ( + 7315D8472A696EFC00B7CE4F /* BulletPointViewCell.swift */, + 7315D8482A696EFC00B7CE4F /* BulletPointViewCell.xib */, + ); + path = BulletPoint; + sourceTree = ""; + }; + 732D1C2C2A66BA9200FB5BFE /* Helper */ = { + isa = PBXGroup; + children = ( + 732D1C2D2A66BAEA00FB5BFE /* LocalizationHelper.swift */, + 73F62F7B2A6E4D79007CBC36 /* BulletinHelper.swift */, + ); + path = Helper; + sourceTree = ""; + }; + 732D1C2F2A66C67600FB5BFE /* Categories */ = { + isa = PBXGroup; + children = ( + 732D1C302A66C6F500FB5BFE /* UILabel+FontStyle.swift */, + 73E824FA2A6A51AD007AA8D7 /* NSAttributedString+Utility.swift */, + 73E824F82A6A4F72007AA8D7 /* String+HTML.swift */, + 73D8C8402A715A6400652504 /* String+Unicode.swift */, + 73D8C8422A7164C700652504 /* UIView+SubviewAspectSize.swift */, + ); + path = Categories; + sourceTree = ""; + }; + 732FF0E32A67A2F800904913 /* Controllers */ = { + isa = PBXGroup; + children = ( + 73E28D902A77E0DE002F73B3 /* BulletinListVC.swift */, + 73E28D912A77E0DE002F73B3 /* BulletinListVC.xib */, + 738B01EF2A6819C900CFDB09 /* BulletinListSectionController.swift */, + ); + path = Controllers; + sourceTree = ""; + }; + 73B17D5C2A6648C90085EB1A /* Constants */ = { + isa = PBXGroup; + children = ( + 73B17D5F2A6649240085EB1A /* Appearance.swift */, + 73B17D5D2A6649240085EB1A /* Constants.swift */, + 73B17D5E2A6649240085EB1A /* Text.swift */, + ); + path = Constants; + sourceTree = ""; + }; + 73CC100D2A65009000BB08C5 /* View */ = { + isa = PBXGroup; + children = ( + 7315D8422A68E8A800B7CE4F /* BulletPoint */, + 7315D83D2A68E88A00B7CE4F /* ActionButton */, + 7315D8342A68E81D00B7CE4F /* Message */, + 7315D82F2A68E7F100B7CE4F /* Media */, + 73CC100E2A6509B800BB08C5 /* Title */, + ); + path = View; + sourceTree = ""; + }; + 73CC100E2A6509B800BB08C5 /* Title */ = { + isa = PBXGroup; + children = ( + 7315D8572A69703700B7CE4F /* TitleViewCell.swift */, + 7315D8582A69703700B7CE4F /* TitleViewCell.xib */, + ); + path = Title; + sourceTree = ""; + }; + 73CC10152A650CD800BB08C5 /* Classes */ = { + isa = PBXGroup; + children = ( + 732D1C2F2A66C67600FB5BFE /* Categories */, + 73CC10162A650CEE00BB08C5 /* Base */, + 73B17D5C2A6648C90085EB1A /* Constants */, + 732D1C2C2A66BA9200FB5BFE /* Helper */, + ); + path = Classes; + sourceTree = ""; + }; + 73CC10162A650CEE00BB08C5 /* Base */ = { + isa = PBXGroup; + children = ( + 73CC10172A650CF800BB08C5 /* View */, + ); + path = Base; + sourceTree = ""; + }; + 73CC10172A650CF800BB08C5 /* View */ = { + isa = PBXGroup; + children = ( + 73CC10182A650D1600BB08C5 /* BaseCollectionViewCell.swift */, + ); + path = View; + sourceTree = ""; + }; + 73E824FC2A6A6545007AA8D7 /* Libraries */ = { + isa = PBXGroup; + children = ( + 73F62F762A6E2CBC007CBC36 /* PopUp */, + 73E824FD2A6A67D4007AA8D7 /* PushButton */, + ); + path = Libraries; + sourceTree = ""; + }; + 73E824FD2A6A67D4007AA8D7 /* PushButton */ = { + isa = PBXGroup; + children = ( + 73E824FE2A6A67F5007AA8D7 /* PushButton.swift */, + ); + path = PushButton; + sourceTree = ""; + }; + 73F62F762A6E2CBC007CBC36 /* PopUp */ = { + isa = PBXGroup; + children = ( + 73F62F772A6E2CF0007CBC36 /* BottomSheetSegue.swift */, + 73F62F792A6E2D0E007CBC36 /* AlertSegue.swift */, + ); + path = PopUp; + sourceTree = ""; + }; + 73F62F7F2A6E9066007CBC36 /* Resources */ = { + isa = PBXGroup; + children = ( + 73F62F802A6E9077007CBC36 /* Fonts */, + ); + path = Resources; + sourceTree = ""; + }; + 73F62F802A6E9077007CBC36 /* Fonts */ = { + isa = PBXGroup; + children = ( + 73F62F812A6E9082007CBC36 /* IBMPlexSans */, + ); + path = Fonts; + sourceTree = ""; + }; + 73F62F812A6E9082007CBC36 /* IBMPlexSans */ = { + isa = PBXGroup; + children = ( + 73F62F862A6E90B1007CBC36 /* IBMPlexSans-Bold.ttf */, + 73F62F872A6E90B1007CBC36 /* IBMPlexSans-BoldItalic.ttf */, + 73F62F852A6E90B1007CBC36 /* IBMPlexSans-Medium.ttf */, + 73F62F822A6E90B1007CBC36 /* IBMPlexSans-Regular.ttf */, + 73F62F832A6E90B1007CBC36 /* IBMPlexSans-SemiBold.ttf */, + 73F62F842A6E90B1007CBC36 /* IBMPlexSans-SemiBoldItalic.ttf */, + ); + path = IBMPlexSans; + sourceTree = ""; + }; + 815E3D6C28DC85510042CEA5 = { + isa = PBXGroup; + children = ( + 815E3DA528DC884C0042CEA5 /* BulletinSDK */, + 815E3D7728DC85510042CEA5 /* Bulletin */, + 815E3D7628DC85510042CEA5 /* Products */, + 4BE0D836F189FD1FC7E5D668 /* Pods */, + 6BB9BBCB1B81AA5BB2878A15 /* Frameworks */, + ); + sourceTree = ""; + }; + 815E3D7628DC85510042CEA5 /* Products */ = { + isa = PBXGroup; + children = ( + 815E3D7528DC85510042CEA5 /* Bulletin.app */, + ); + name = Products; + sourceTree = ""; + }; + 815E3D7728DC85510042CEA5 /* Bulletin */ = { + isa = PBXGroup; + children = ( + 732FF0E32A67A2F800904913 /* Controllers */, + 815E3D7828DC85510042CEA5 /* AppDelegate.swift */, + 815E3D7A28DC85510042CEA5 /* SceneDelegate.swift */, + 815E3D7C28DC85510042CEA5 /* ViewController.swift */, + 815E3D7E28DC85510042CEA5 /* Main.storyboard */, + 815E3D8128DC85510042CEA5 /* Assets.xcassets */, + 815E3D8328DC85510042CEA5 /* LaunchScreen.storyboard */, + 815E3D8628DC85510042CEA5 /* Info.plist */, + ); + path = Bulletin; + sourceTree = ""; + }; + 815E3DA528DC884C0042CEA5 /* BulletinSDK */ = { + isa = PBXGroup; + children = ( + 73CC10152A650CD800BB08C5 /* Classes */, + 815E3DA928DC884C0042CEA5 /* Modals */, + 73CC100D2A65009000BB08C5 /* View */, + 815E3DA628DC884C0042CEA5 /* Extensions */, + 73E824FC2A6A6545007AA8D7 /* Libraries */, + 73F62F7F2A6E9066007CBC36 /* Resources */, + 815E3DB128DC884C0042CEA5 /* BulletinSDK.swift */, + 815E3DA828DC884C0042CEA5 /* BulletinDataStore.swift */, + ); + name = BulletinSDK; + path = ../BulletinSDK; + sourceTree = ""; + }; + 815E3DA628DC884C0042CEA5 /* Extensions */ = { + isa = PBXGroup; + children = ( + 815E3DA728DC884C0042CEA5 /* String+Class.swift */, + 81E010E128DDA2D9003FFE79 /* UserDefaults+Storage.swift */, + 819772DF28E40C4800962913 /* String+Version.swift */, + ); + path = Extensions; + sourceTree = ""; + }; + 815E3DA928DC884C0042CEA5 /* Modals */ = { + isa = PBXGroup; + children = ( + 819772E128E41D8200962913 /* UI Modals */, + 819772DB28E2CBEF00962913 /* BulletinInfo.swift */, + 819772DD28E40B8100962913 /* Version.swift */, + ); + path = Modals; + sourceTree = ""; + }; + 819772E128E41D8200962913 /* UI Modals */ = { + isa = PBXGroup; + children = ( + 815E3DAA28DC884C0042CEA5 /* BulletinItem.swift */, + 815E3DAE28DC884C0042CEA5 /* Title.swift */, + 815E3DAC28DC884C0042CEA5 /* Message.swift */, + 815E3DAD28DC884C0042CEA5 /* BulletPoint.swift */, + 815E3DAF28DC884C0042CEA5 /* Media.swift */, + 815E3DB028DC884C0042CEA5 /* ActionButton.swift */, + ); + path = "UI Modals"; + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXNativeTarget section */ + 815E3D7428DC85510042CEA5 /* Bulletin */ = { + isa = PBXNativeTarget; + buildConfigurationList = 815E3D8928DC85510042CEA5 /* Build configuration list for PBXNativeTarget "Bulletin" */; + buildPhases = ( + 3204137CC314034C6270CB20 /* [CP] Check Pods Manifest.lock */, + 815E3D7128DC85510042CEA5 /* Sources */, + 815E3D7228DC85510042CEA5 /* Frameworks */, + 815E3D7328DC85510042CEA5 /* Resources */, + 21CE3D15751E0A8B38141E27 /* [CP] Embed Pods Frameworks */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = Bulletin; + productName = Bulletin; + productReference = 815E3D7528DC85510042CEA5 /* Bulletin.app */; + productType = "com.apple.product-type.application"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + 815E3D6D28DC85510042CEA5 /* Project object */ = { + isa = PBXProject; + attributes = { + BuildIndependentTargetsInParallel = 1; + CLASSPREFIX = ""; + LastSwiftUpdateCheck = 1400; + LastUpgradeCheck = 1400; + ORGANIZATIONNAME = "Copyright © 2022 Zanmai Labs Private Limited."; + TargetAttributes = { + 815E3D7428DC85510042CEA5 = { + CreatedOnToolsVersion = 14.0; + }; + }; + }; + buildConfigurationList = 815E3D7028DC85510042CEA5 /* Build configuration list for PBXProject "Bulletin" */; + compatibilityVersion = "Xcode 14.0"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + en, + Base, + ); + mainGroup = 815E3D6C28DC85510042CEA5; + productRefGroup = 815E3D7628DC85510042CEA5 /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 815E3D7428DC85510042CEA5 /* Bulletin */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 815E3D7328DC85510042CEA5 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 73F62F892A6E90B1007CBC36 /* IBMPlexSans-SemiBold.ttf in Resources */, + 7315D8522A696FA100B7CE4F /* MessageViewCell.xib in Resources */, + 73F62F8C2A6E90B1007CBC36 /* IBMPlexSans-Bold.ttf in Resources */, + 73F62F8A2A6E90B1007CBC36 /* IBMPlexSans-SemiBoldItalic.ttf in Resources */, + 7315D85A2A69703700B7CE4F /* TitleViewCell.xib in Resources */, + 73F62F882A6E90B1007CBC36 /* IBMPlexSans-Regular.ttf in Resources */, + 7315D8562A696FE400B7CE4F /* MediaViewCell.xib in Resources */, + 73E28D932A77E0DE002F73B3 /* BulletinListVC.xib in Resources */, + 73F62F8B2A6E90B1007CBC36 /* IBMPlexSans-Medium.ttf in Resources */, + 815E3D8528DC85510042CEA5 /* LaunchScreen.storyboard in Resources */, + 815E3D8228DC85510042CEA5 /* Assets.xcassets in Resources */, + 815E3D8028DC85510042CEA5 /* Main.storyboard in Resources */, + 73F62F8D2A6E90B1007CBC36 /* IBMPlexSans-BoldItalic.ttf in Resources */, + 7315D84E2A696F4300B7CE4F /* ActionButtonViewCell.xib in Resources */, + 7315D84A2A696EFC00B7CE4F /* BulletPointViewCell.xib in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXShellScriptBuildPhase section */ + 21CE3D15751E0A8B38141E27 /* [CP] Embed Pods Frameworks */ = { + isa = PBXShellScriptBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + "${PODS_ROOT}/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-${CONFIGURATION}-input-files.xcfilelist", + ); + name = "[CP] Embed Pods Frameworks"; + outputFileListPaths = ( + "${PODS_ROOT}/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-${CONFIGURATION}-output-files.xcfilelist", + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "\"${PODS_ROOT}/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks.sh\"\n"; + showEnvVarsInLog = 0; + }; + 3204137CC314034C6270CB20 /* [CP] Check Pods Manifest.lock */ = { + isa = PBXShellScriptBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + inputFileListPaths = ( + ); + inputPaths = ( + "${PODS_PODFILE_DIR_PATH}/Podfile.lock", + "${PODS_ROOT}/Manifest.lock", + ); + name = "[CP] Check Pods Manifest.lock"; + outputFileListPaths = ( + ); + outputPaths = ( + "$(DERIVED_FILE_DIR)/Pods-Bulletin-checkManifestLockResult.txt", + ); + runOnlyForDeploymentPostprocessing = 0; + shellPath = /bin/sh; + shellScript = "diff \"${PODS_PODFILE_DIR_PATH}/Podfile.lock\" \"${PODS_ROOT}/Manifest.lock\" > /dev/null\nif [ $? != 0 ] ; then\n # print error to STDERR\n echo \"error: The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation.\" >&2\n exit 1\nfi\n# This output is used by Xcode 'outputs' to avoid re-running this script phase.\necho \"SUCCESS\" > \"${SCRIPT_OUTPUT_FILE_0}\"\n"; + showEnvVarsInLog = 0; + }; +/* End PBXShellScriptBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 815E3D7128DC85510042CEA5 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 732D1C2E2A66BAEA00FB5BFE /* LocalizationHelper.swift in Sources */, + 7315D8552A696FE400B7CE4F /* MediaViewCell.swift in Sources */, + 815E3DB928DC884C0042CEA5 /* Media.swift in Sources */, + 73B17D602A6649240085EB1A /* Constants.swift in Sources */, + 73F62F782A6E2CF0007CBC36 /* BottomSheetSegue.swift in Sources */, + 7315D8492A696EFC00B7CE4F /* BulletPointViewCell.swift in Sources */, + 73D8C8412A715A6400652504 /* String+Unicode.swift in Sources */, + 815E3DB828DC884C0042CEA5 /* Title.swift in Sources */, + 732D1C312A66C6F500FB5BFE /* UILabel+FontStyle.swift in Sources */, + 73E824FF2A6A67F5007AA8D7 /* PushButton.swift in Sources */, + 73B17D622A6649240085EB1A /* Appearance.swift in Sources */, + 815E3D7D28DC85510042CEA5 /* ViewController.swift in Sources */, + 7315D8512A696FA100B7CE4F /* MessageViewCell.swift in Sources */, + 73CC10192A650D1600BB08C5 /* BaseCollectionViewCell.swift in Sources */, + 73B17D612A6649240085EB1A /* Text.swift in Sources */, + 7315D84D2A696F4300B7CE4F /* ActionButtonViewCell.swift in Sources */, + 815E3DB428DC884C0042CEA5 /* BulletinItem.swift in Sources */, + 81E010E228DDA2D9003FFE79 /* UserDefaults+Storage.swift in Sources */, + 73E28D922A77E0DE002F73B3 /* BulletinListVC.swift in Sources */, + 815E3DB328DC884C0042CEA5 /* BulletinDataStore.swift in Sources */, + 815E3DBB28DC884C0042CEA5 /* BulletinSDK.swift in Sources */, + 819772DE28E40B8100962913 /* Version.swift in Sources */, + 738B01F02A6819C900CFDB09 /* BulletinListSectionController.swift in Sources */, + 7315D8592A69703700B7CE4F /* TitleViewCell.swift in Sources */, + 73E824F92A6A4F72007AA8D7 /* String+HTML.swift in Sources */, + 815E3DB228DC884C0042CEA5 /* String+Class.swift in Sources */, + 73D8C8432A7164C700652504 /* UIView+SubviewAspectSize.swift in Sources */, + 819772E028E40C4800962913 /* String+Version.swift in Sources */, + 815E3DB728DC884C0042CEA5 /* BulletPoint.swift in Sources */, + 819772DC28E2CBEF00962913 /* BulletinInfo.swift in Sources */, + 73F62F7A2A6E2D0E007CBC36 /* AlertSegue.swift in Sources */, + 815E3DB628DC884C0042CEA5 /* Message.swift in Sources */, + 815E3D7928DC85510042CEA5 /* AppDelegate.swift in Sources */, + 815E3D7B28DC85510042CEA5 /* SceneDelegate.swift in Sources */, + 73F62F7C2A6E4D79007CBC36 /* BulletinHelper.swift in Sources */, + 73E824FB2A6A51AD007AA8D7 /* NSAttributedString+Utility.swift in Sources */, + 815E3DBA28DC884C0042CEA5 /* ActionButton.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXVariantGroup section */ + 815E3D7E28DC85510042CEA5 /* Main.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 815E3D7F28DC85510042CEA5 /* Base */, + ); + name = Main.storyboard; + sourceTree = ""; + }; + 815E3D8328DC85510042CEA5 /* LaunchScreen.storyboard */ = { + isa = PBXVariantGroup; + children = ( + 815E3D8428DC85510042CEA5 /* Base */, + ); + name = LaunchScreen.storyboard; + sourceTree = ""; + }; +/* End PBXVariantGroup section */ + +/* Begin XCBuildConfiguration section */ + 815E3D8728DC85510042CEA5 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_ENABLE_OBJC_WEAK = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE; + MTL_FAST_MATH = YES; + ONLY_ACTIVE_ARCH = YES; + SDKROOT = iphoneos; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + }; + name = Debug; + }; + 815E3D8828DC85510042CEA5 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++20"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_ENABLE_OBJC_WEAK = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + MTL_ENABLE_DEBUG_INFO = NO; + MTL_FAST_MATH = YES; + SDKROOT = iphoneos; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + VALIDATE_PRODUCT = YES; + }; + name = Release; + }; + 815E3D8A28DC85510042CEA5 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = F5FFA406F95FB2E07D3D917C /* Pods-Bulletin.debug.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + DEVELOPMENT_TEAM = CAQ757V6Q3; + GENERATE_INFOPLIST_FILE = YES; + INFOPLIST_FILE = Bulletin/Info.plist; + INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES; + INFOPLIST_KEY_UILaunchStoryboardName = LaunchScreen; + INFOPLIST_KEY_UIMainStoryboardFile = Main; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.wrx.Bulletin.Bulletin; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_EMIT_LOC_STRINGS = YES; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + }; + name = Debug; + }; + 815E3D8B28DC85510042CEA5 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 3D5C61AE690BD66E176DA0F5 /* Pods-Bulletin.release.xcconfig */; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; + ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor; + CODE_SIGN_STYLE = Automatic; + CURRENT_PROJECT_VERSION = 1; + DEVELOPMENT_TEAM = CAQ757V6Q3; + GENERATE_INFOPLIST_FILE = YES; + INFOPLIST_FILE = Bulletin/Info.plist; + INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES; + INFOPLIST_KEY_UILaunchStoryboardName = LaunchScreen; + INFOPLIST_KEY_UIMainStoryboardFile = Main; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight"; + IPHONEOS_DEPLOYMENT_TARGET = 13.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + ); + MARKETING_VERSION = 1.0; + PRODUCT_BUNDLE_IDENTIFIER = com.wrx.Bulletin.Bulletin; + PRODUCT_NAME = "$(TARGET_NAME)"; + SWIFT_EMIT_LOC_STRINGS = YES; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + }; + name = Release; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 815E3D7028DC85510042CEA5 /* Build configuration list for PBXProject "Bulletin" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 815E3D8728DC85510042CEA5 /* Debug */, + 815E3D8828DC85510042CEA5 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 815E3D8928DC85510042CEA5 /* Build configuration list for PBXNativeTarget "Bulletin" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 815E3D8A28DC85510042CEA5 /* Debug */, + 815E3D8B28DC85510042CEA5 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = 815E3D6D28DC85510042CEA5 /* Project object */; +} diff --git a/Demo/Bulletin.xcodeproj/project.xcworkspace/contents.xcworkspacedata b/Demo/Bulletin.xcodeproj/project.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..919434a --- /dev/null +++ b/Demo/Bulletin.xcodeproj/project.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,7 @@ + + + + + diff --git a/Demo/Bulletin.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/Demo/Bulletin.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/Demo/Bulletin.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/Demo/Bulletin.xcodeproj/project.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/UserInterfaceState.xcuserstate b/Demo/Bulletin.xcodeproj/project.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/UserInterfaceState.xcuserstate new file mode 100644 index 0000000..d758fbd Binary files /dev/null and b/Demo/Bulletin.xcodeproj/project.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/UserInterfaceState.xcuserstate differ diff --git a/Demo/Bulletin.xcworkspace/contents.xcworkspacedata b/Demo/Bulletin.xcworkspace/contents.xcworkspacedata new file mode 100644 index 0000000..21040ec --- /dev/null +++ b/Demo/Bulletin.xcworkspace/contents.xcworkspacedata @@ -0,0 +1,10 @@ + + + + + + + diff --git a/Demo/Bulletin.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist b/Demo/Bulletin.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist new file mode 100644 index 0000000..18d9810 --- /dev/null +++ b/Demo/Bulletin.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist @@ -0,0 +1,8 @@ + + + + + IDEDidComputeMac32BitWarning + + + diff --git a/Demo/Bulletin.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/UserInterfaceState.xcuserstate b/Demo/Bulletin.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/UserInterfaceState.xcuserstate new file mode 100644 index 0000000..5ff5c64 Binary files /dev/null and b/Demo/Bulletin.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/UserInterfaceState.xcuserstate differ diff --git a/Demo/Bulletin.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/xcdebugger/Breakpoints_v2.xcbkptlist b/Demo/Bulletin.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/xcdebugger/Breakpoints_v2.xcbkptlist new file mode 100644 index 0000000..f945724 --- /dev/null +++ b/Demo/Bulletin.xcworkspace/xcuserdata/daxeshnagar.xcuserdatad/xcdebugger/Breakpoints_v2.xcbkptlist @@ -0,0 +1,24 @@ + + + + + + + + + diff --git a/Demo/Bulletin/AppDelegate.swift b/Demo/Bulletin/AppDelegate.swift new file mode 100644 index 0000000..eb56155 --- /dev/null +++ b/Demo/Bulletin/AppDelegate.swift @@ -0,0 +1,36 @@ +// +// AppDelegate.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit + +@main +class AppDelegate: UIResponder, UIApplicationDelegate { + + + + func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { + // Override point for customization after application launch. + return true + } + + // MARK: UISceneSession Lifecycle + + func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration { + // Called when a new scene session is being created. + // Use this method to select a configuration to create the new scene with. + return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role) + } + + func application(_ application: UIApplication, didDiscardSceneSessions sceneSessions: Set) { + // Called when the user discards a scene session. + // If any sessions were discarded while the application was not running, this will be called shortly after application:didFinishLaunchingWithOptions. + // Use this method to release any resources that were specific to the discarded scenes, as they will not return. + } + + +} + diff --git a/Demo/Bulletin/Assets.xcassets/AccentColor.colorset/Contents.json b/Demo/Bulletin/Assets.xcassets/AccentColor.colorset/Contents.json new file mode 100644 index 0000000..eb87897 --- /dev/null +++ b/Demo/Bulletin/Assets.xcassets/AccentColor.colorset/Contents.json @@ -0,0 +1,11 @@ +{ + "colors" : [ + { + "idiom" : "universal" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Demo/Bulletin/Assets.xcassets/AppIcon.appiconset/Contents.json b/Demo/Bulletin/Assets.xcassets/AppIcon.appiconset/Contents.json new file mode 100644 index 0000000..13613e3 --- /dev/null +++ b/Demo/Bulletin/Assets.xcassets/AppIcon.appiconset/Contents.json @@ -0,0 +1,13 @@ +{ + "images" : [ + { + "idiom" : "universal", + "platform" : "ios", + "size" : "1024x1024" + } + ], + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Demo/Bulletin/Assets.xcassets/Contents.json b/Demo/Bulletin/Assets.xcassets/Contents.json new file mode 100644 index 0000000..73c0059 --- /dev/null +++ b/Demo/Bulletin/Assets.xcassets/Contents.json @@ -0,0 +1,6 @@ +{ + "info" : { + "author" : "xcode", + "version" : 1 + } +} diff --git a/Demo/Bulletin/Base.lproj/LaunchScreen.storyboard b/Demo/Bulletin/Base.lproj/LaunchScreen.storyboard new file mode 100644 index 0000000..865e932 --- /dev/null +++ b/Demo/Bulletin/Base.lproj/LaunchScreen.storyboard @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Bulletin/Base.lproj/Main.storyboard b/Demo/Bulletin/Base.lproj/Main.storyboard new file mode 100644 index 0000000..840da48 --- /dev/null +++ b/Demo/Bulletin/Base.lproj/Main.storyboard @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Bulletin/Controllers/BulletinListSectionController.swift b/Demo/Bulletin/Controllers/BulletinListSectionController.swift new file mode 100644 index 0000000..92d43c4 --- /dev/null +++ b/Demo/Bulletin/Controllers/BulletinListSectionController.swift @@ -0,0 +1,290 @@ +// +// BulletinListSectionController.swift +// Bulletin +// +// Created by Daxesh Nagar on 19/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import Foundation +import IGListKit +import UIKit + +internal protocol BulletinSectionControllerDelegate: AnyObject { + func bulletinSectionController(_ sectionController: BulletinListSectionController, didClickItem item: BulletinItem) +} + +class BulletinListSectionController: ListSectionController { + + // MARK: - Variable + private var bulletinListSection: BulletinInfo? + public weak var delegate: BulletinSectionControllerDelegate? + + private var bulletPointViewCell: BulletPointViewCell? + private var actionButtonViewCell: ActionButtonViewCell? + private var messageViewCell: MessageViewCell? + private var mediaViewCell: MediaViewCell? + private var titleViewCell: TitleViewCell? + + + // MARK: - Initialisation Methods + override init() { + super.init() + + // Set Minimum Spacing + minimumLineSpacing = 16 + inset = UIEdgeInsets(top: 20, left: 0, bottom:0, right: 0) + + + // Init Sizing Cells + bulletPointViewCell = Bundle.main.loadNibNamed("BulletPointViewCell", owner: self, options: nil)?.first as? BulletPointViewCell + actionButtonViewCell = Bundle.main.loadNibNamed("ActionButtonViewCell", owner: self, options: nil)?.first as? ActionButtonViewCell + messageViewCell = Bundle.main.loadNibNamed("MessageViewCell", owner: self, options: nil)?.first as? MessageViewCell + mediaViewCell = Bundle.main.loadNibNamed("MediaViewCell", owner: self, options: nil)?.first as? MediaViewCell + titleViewCell = Bundle.main.loadNibNamed("TitleViewCell", owner: self, options: nil)?.first as? TitleViewCell + } + + + // MARK: - IGListSectionController + override func numberOfItems() -> Int { + return bulletinListSection?.items.count ?? 0 + } + + override func sizeForItem(at index: Int) -> CGSize { + + // Validation + guard let context = collectionContext, + let item = bulletinListSection?.items[index] else { return .zero } + + switch item.type { + + case .title: + + // Calculate Width + let width = context.containerSize.width - inset.left - inset.right + + // Set Cell Item + titleViewCell?.frame = CGRect(x: 0.0, y: 0.0, width: width, height: CGFloat.greatestFiniteMagnitude) + titleViewCell?.item = item as? Title + + // Calculate Height + let height = max(titleViewCell?.intrinsicContentSize.height ?? 0 , 0) + + // Return Size + return CGSize(width: width, height: height) + + case .message: + + // Set Cell Item + messageViewCell?.frame = CGRect(x: 0.0, y: 0.0, width: context.containerSize.width - inset.left - inset.right, height: CGFloat.greatestFiniteMagnitude) + messageViewCell?.item = item as? Message + + // Calculate Height + let height = max(messageViewCell?.intrinsicContentSize.height ?? 0 , 0) + + // Return Size + return CGSize(width: context.containerSize.width - inset.left - inset.right, height: height) + + case .media: + + // Set Announcement Info + let cellWidth = context.containerSize.width - inset.left - inset.right + mediaViewCell?.frame = CGRect(x: 0.0, y: 0.0, width: cellWidth, height: CGFloat.greatestFiniteMagnitude) + mediaViewCell?.item = item as? Media + + // Calculate Size + let size = CGSize(width: cellWidth, height: mediaViewCell?.intrinsicContentSize.height ?? 0.0) + + return size + + case .bulletPoint: + + // Set Cell Item + bulletPointViewCell?.frame = CGRect(x: 0.0, y: 0.0, width: context.containerSize.width, height: CGFloat.greatestFiniteMagnitude) + bulletPointViewCell?.item = item as? BulletPoint + + // Calculate Height + let height = max(bulletPointViewCell?.intrinsicContentSize.height ?? 0 , 0) + + // Return Size + return CGSize(width: context.containerSize.width, height: height) + + case .actionButton: + + // Set Cell Item + actionButtonViewCell?.frame = CGRect(x: 0.0, y: 0.0, width: context.containerSize.width, height: CGFloat.greatestFiniteMagnitude) + actionButtonViewCell?.item = item as? ActionButton + + // Calculate Height + let height = max(actionButtonViewCell?.intrinsicContentSize.height ?? 0 , 0) + + // Return Size + return CGSize(width: context.containerSize.width, height: height) + + case .undefined: + return CGSize(width: 0, height: 0) + } + } + + override func cellForItem(at index: Int) -> UICollectionViewCell { + + // Validation + guard let items = bulletinListSection?.items else { + fatalError() + } + + let item = items[index] + + switch item.type { + + case .title: + + // Get Cell + guard let cell = collectionContext?.dequeueReusableCell(withNibName: TitleViewCell.identifier(), + bundle: nil, for: self, at: index) as? TitleViewCell else + { fatalError() } + + // Item Validation + if let item = item as? Title { + + // Set Item + cell.item = item + } + + // Set Delegate + cell.delegate = self + + return cell + + case .message: + + // Get Cell + // Get Cell + guard let cell = collectionContext?.dequeueReusableCell(withNibName: MessageViewCell.identifier(), + bundle: nil, for: self, at: index) as? MessageViewCell else + { fatalError() } + + // Item Validation + if let item = item as? Message { + + // Set Item + cell.item = item + } + + return cell + + case .media: + + // Get Cell + guard let cell = collectionContext?.dequeueReusableCell(withNibName: MediaViewCell.identifier(), + bundle: nil, for: self, at: index) as? MediaViewCell else + { fatalError() } + + // Item Validation + if let item = item as? Media { + + // Set Item + cell.item = item + } + + // Set Delegate + cell.delegate = self + + return cell + + case .bulletPoint: + + // Get Cell + guard let cell = collectionContext?.dequeueReusableCell(withNibName: BulletPointViewCell.identifier(), + bundle: nil, for: self, at: index) as? BulletPointViewCell else + { fatalError() } + + // Item Validation + if let item = item as? BulletPoint { + + // Set Item + cell.item = item + } + + // Set Delegate + cell.delegate = self + + return cell + + case .actionButton: + + // Get Cell + guard let cell = collectionContext?.dequeueReusableCell(withNibName: ActionButtonViewCell.identifier(), + bundle: nil, for: self, at: index) as? ActionButtonViewCell else + { fatalError() } + + // Item Validation + if let item = item as? ActionButton { + + // Set Item + cell.item = item + } + + // Set Delegate + cell.delegate = self + + return cell + + case .undefined: + fatalError() + } + } + + override func didUpdate(to object: Any) { + bulletinListSection = object as? BulletinInfo + } +} + + + +// MARK: - BulletListTitleCellDelegate +extension BulletinListSectionController: TitleViewCellDelegate { + + func titleViewCell(_ cell: TitleViewCell, ofItem item: BulletinItem) { + + } + +} + +// MARK: - BulletListTitleCellDelegate +extension BulletinListSectionController: MediaViewCellDelegate { + + func mediaViewCell(_ cell: MediaViewCell, ofItem item: BulletinItem) { + + } + +} + + +// MARK: - BulletListTitleCellDelegate +extension BulletinListSectionController: MessageViewCellDelegate { + + func messageViewCell(_ cell: MessageViewCell, ofItem item: BulletinItem) { + + } + +} + +// MARK: - BulletListTitleCellDelegate +extension BulletinListSectionController: ActionButtonViewCellDelegate { + + func actionButtonViewCell(_ cell: ActionButtonViewCell, ofItem item: BulletinItem) { + delegate?.bulletinSectionController(self, didClickItem: item) + } + +} + +// MARK: - BulletListTitleCellDelegate +extension BulletinListSectionController: BulletPointViewCellDelegate { + + func bulletPointViewCell(_ cell: BulletPointViewCell, ofItem item: BulletinItem) { + delegate?.bulletinSectionController(self, didClickItem: item) + } + +} + diff --git a/Demo/Bulletin/Controllers/BulletinListVC.swift b/Demo/Bulletin/Controllers/BulletinListVC.swift new file mode 100644 index 0000000..e28e0b2 --- /dev/null +++ b/Demo/Bulletin/Controllers/BulletinListVC.swift @@ -0,0 +1,171 @@ +// +// BulletinListVC.swift +// Bulletin +// +// Created by Daxesh Nagar on 31/07/23. +// Copyright © 2023 Copyright © 2022 Zanmai Labs Private Limited. All rights reserved. +// + +import UIKit +import IGListKit + +internal protocol BulletinListDelegate: AnyObject { + func BulletinList(didClickItem item: BulletinItem) +} + +class BulletinListVC: UIViewController { + + // MARK: - Variables + @IBOutlet private var collectionView : UICollectionView! + @IBOutlet private var headerTitleLabel : UILabel! + @IBOutlet private var headerView : UIView! + @IBOutlet private var footerView : UIStackView! + @IBOutlet private var gotItButton : UIButton! + @IBOutlet private weak var collectionViewHeightConstraint: NSLayoutConstraint? + + public weak var delegate: BulletinListDelegate? + + private var bulletinSection = [BulletinInfo]() + + + internal var bulletinItems : [ListDiffable] { + return bulletinSection + } + + internal lazy var adapter: ListAdapter = { + return ListAdapter(updater: ListAdapterUpdater(), viewController: nil, workingRangeSize: 0) + }() + + + // MARK: - Initialisation Methods + public class func instance(items: [BulletinInfo]) -> BulletinListVC { + + // Create Bulletin VC + let bulletinVC = BulletinListVC() + bulletinVC.bulletinSection = items + return bulletinVC + } + + // MARK: - View Lifecycle Methods + func loadVariables() { + + // Configure Adapter Properties + adapter.collectionView = collectionView + adapter.dataSource = self + adapter.collectionViewDelegate = self + + gotItButton.layer.cornerRadius = AppStyle.ButtonCornerRadius + + // Set Insets + collectionView.contentInset = UIEdgeInsets(top: 0, left: 0, bottom: 20, right: 0) + + updateAppearance() + + updateContent() + } + + func updateAppearance() { + + // Set Default Properties + headerView.backgroundColor = AppStyle.Color.MainNavigationBg + footerView.backgroundColor = AppStyle.Color.MainBgSurface_Alt + gotItButton.backgroundColor = AppStyle.Color.BrandBgPrimary + + headerTitleLabel.textColor = AppStyle.Color.BrandTextOnPrimary + headerTitleLabel.large_semibold() + + gotItButton.setTitleColor(AppStyle.Color.BrandTextOnPrimary, for: .normal) + gotItButton.titleLabel?.base_semibold() + + } + + func updateContent() { + + // Set Default Proeprties + headerTitleLabel.text = Text.WhatsNewInThisUpdate() + gotItButton.setTitle(Text.GotIt().uppercased(), for: .normal) + } + + // MARK: - Initialisation Methods + override func viewDidLoad() { + super.viewDidLoad() + + // Do any additional setup after loading the view. + + // Load Variables + loadVariables() + } + + override func viewDidLayoutSubviews() { + super.viewDidLayoutSubviews() + + collectionView.collectionViewLayout.invalidateLayout() + } + + + // MARK: - Helper Method + public func reload(animated: Bool, completion: ListUpdaterCompletion? = nil) { + + DispatchQueue.main.async { [weak self] in + guard let weakSelf = self else { return } + + // Perform Updates + weakSelf.adapter.performUpdates(animated: animated, completion: {(finished) in + + // ReLayout to Forces View And Its Subviews to update immediately + weakSelf.view.layoutIfNeeded() + var superViewHeight: CGFloat = 480 + let minTopMargin: CGFloat = 50 + var collectionViewHeight = weakSelf.collectionView.contentSize.height + let extraViewHeight: CGFloat = weakSelf.headerView.frame.height + weakSelf.footerView.frame.height + if let window = UIApplication.shared.keyWindow { + superViewHeight = window.frame.size.height - window.safeAreaInsets.top - window.safeAreaInsets.bottom + } + if collectionViewHeight > (superViewHeight - minTopMargin - extraViewHeight) { + collectionViewHeight = superViewHeight - minTopMargin - extraViewHeight + weakSelf.collectionView.isScrollEnabled = true + } else { + weakSelf.collectionView.isScrollEnabled = false + } + + let contentHeight = min(collectionViewHeight, superViewHeight) + weakSelf.collectionViewHeightConstraint?.constant = contentHeight + weakSelf.view.setNeedsLayout() + weakSelf.preferredContentSize = CGSize(width: weakSelf.preferredContentSize.width, height: superViewHeight - 40) + completion?(finished) + }) + } + } + +} + +// MARK: - ListAdapterDataSource +extension BulletinListVC: ListAdapterDataSource { + + func objects(for listAdapter: ListAdapter) -> [ListDiffable] { + return bulletinItems + } + + func listAdapter(_ listAdapter: ListAdapter, sectionControllerFor object: Any) -> ListSectionController { + let sectionController = BulletinListSectionController() + sectionController.delegate = self + return sectionController + } + + func emptyView(for listAdapter: ListAdapter) -> UIView? { return nil } +} + +// MARK: - UICollectionViewDelegate +extension BulletinListVC: UICollectionViewDelegate { + public func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {} +} + +// MARK: - BulletinSectionControllerDelegate +extension BulletinListVC: BulletinSectionControllerDelegate { + func bulletinSectionController(_ sectionController: BulletinListSectionController, didClickItem item: BulletinItem) { + + // Clicked Item + delegate?.BulletinList(didClickItem: item) + } + +} diff --git a/Demo/Bulletin/Controllers/BulletinListVC.xib b/Demo/Bulletin/Controllers/BulletinListVC.xib new file mode 100644 index 0000000..85e25ad --- /dev/null +++ b/Demo/Bulletin/Controllers/BulletinListVC.xib @@ -0,0 +1,99 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Bulletin/Info.plist b/Demo/Bulletin/Info.plist new file mode 100644 index 0000000..3d9fcc0 --- /dev/null +++ b/Demo/Bulletin/Info.plist @@ -0,0 +1,34 @@ + + + + + UIApplicationSceneManifest + + UIApplicationSupportsMultipleScenes + + UISceneConfigurations + + UIWindowSceneSessionRoleApplication + + + UISceneConfigurationName + Default Configuration + UISceneDelegateClassName + $(PRODUCT_MODULE_NAME).SceneDelegate + UISceneStoryboardFile + Main + + + + + UIAppFonts + + IBMPlexSans-Bold.ttf + IBMPlexSans-BoldItalic.ttf + IBMPlexSans-Medium.ttf + IBMPlexSans-Regular.ttf + IBMPlexSans-SemiBold.ttf + IBMPlexSans-SemiBoldItalic.ttf + + + diff --git a/Demo/Bulletin/SceneDelegate.swift b/Demo/Bulletin/SceneDelegate.swift new file mode 100644 index 0000000..230eb88 --- /dev/null +++ b/Demo/Bulletin/SceneDelegate.swift @@ -0,0 +1,52 @@ +// +// SceneDelegate.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit + +class SceneDelegate: UIResponder, UIWindowSceneDelegate { + + var window: UIWindow? + + + func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) { + // Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`. + // If using a storyboard, the `window` property will automatically be initialized and attached to the scene. + // This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead). + guard let _ = (scene as? UIWindowScene) else { return } + } + + func sceneDidDisconnect(_ scene: UIScene) { + // Called as the scene is being released by the system. + // This occurs shortly after the scene enters the background, or when its session is discarded. + // Release any resources associated with this scene that can be re-created the next time the scene connects. + // The scene may re-connect later, as its session was not necessarily discarded (see `application:didDiscardSceneSessions` instead). + } + + func sceneDidBecomeActive(_ scene: UIScene) { + // Called when the scene has moved from an inactive state to an active state. + // Use this method to restart any tasks that were paused (or not yet started) when the scene was inactive. + } + + func sceneWillResignActive(_ scene: UIScene) { + // Called when the scene will move from an active state to an inactive state. + // This may occur due to temporary interruptions (ex. an incoming phone call). + } + + func sceneWillEnterForeground(_ scene: UIScene) { + // Called as the scene transitions from the background to the foreground. + // Use this method to undo the changes made on entering the background. + } + + func sceneDidEnterBackground(_ scene: UIScene) { + // Called as the scene transitions from the foreground to the background. + // Use this method to save data, release shared resources, and store enough scene-specific state information + // to restore the scene back to its current state. + } + + +} + diff --git a/Demo/Bulletin/ViewController.swift b/Demo/Bulletin/ViewController.swift new file mode 100644 index 0000000..98bb3de --- /dev/null +++ b/Demo/Bulletin/ViewController.swift @@ -0,0 +1,158 @@ +// +// ViewController.swift +// Bulletin +// +// Created by Pranav Panchal on 22/09/22. +// + +import UIKit +import SwiftMessages + +class ViewController: UIViewController { + + override func viewDidLoad() { + super.viewDidLoad() + // Do any additional setup after loading the view. + + // Creage DataStore Object + let dataSource = BulletinDataStore() + + // Register Multiple Versions +// registerBulletingDetails(forVersion: Version("1.11"), inDataStore: dataSource) +// registerBulletingDetails(forVersion: Version("1.12"), inDataStore: dataSource) +// registerBulletingDetails(forVersion: Version("1.12.1"), inDataStore: dataSource) +// registerBulletingDetails(forVersion: Version("1.12.2"), inDataStore: dataSource) +// registerBulletingDetails(forVersion: Version("1.13"), inDataStore: dataSource) +// registerBulletingDetails(forVersion: Version("1.13.1"), inDataStore: dataSource) +// registerBulletingDetails(forVersion: Version("1.14"), inDataStore: dataSource) + + + let sdk = BulletinSDK(dataStore: dataSource,appearance: Appearance.darkKnight) + let bulletinVC = sdk.getFullBulletin() +// let _ = sdk.getLastBulletins(limit: 5) +// let _ = sdk.getUnseenBulletins(limit: 4) + + // Get Top Most View Controller +// BulletinHelper.topMostViewController { (topMostVC) in +// +// // Validation +// guard let topMostVC = topMostVC else { +// return +// } +// +// guard let bulletinVC = bulletinVC else { +// return +// } +// +// bulletinVC.delegate = self +// +// // Display Self Declaration PopUp VC +// let segue = AlertSegue(identifier: nil, source: topMostVC, destination: bulletinVC) +// topMostVC.prepare(for: segue, sender: nil) +// segue.perform() +// +// bulletinVC.reload(animated: false) +// +// } + } + + private func registerBulletingDetails(forVersion version: Version?, inDataStore dataStore: BulletinDataStore) { + + // Validation + guard let version = version else { + return + } + + let title2 = Title() + title2.preTitleText = "Version " + version.version + title2.titleText = "In this update" + title2.subTitleText = "Vestibulum id ligula porta felis euismod semper. Vesti bu lum id ligula porta felis euismod semper." + + let message2 = Message() + message2.messageType = .text + // message2.text = "

Harry Potter's House

Privet Drive,4
Little Whinging
Surrey
England
Great Britain

" + //"
\n" + "

Harry Potter's House

\n" + "

\n" + "Privet Drive, 4
Little Whinging
Surrey
England
Great Britain\n" + "

\n" + "
" + message2.text = "Vestibulum id ligula porta felis euismod semper. Morbi leo risus, porta ac consectetur ac, vestibulum at eros." + + let media = Media() + media.size = CGSize(width: 1180, height: 596) + media.url = URL(string:"https://media.wazirx.com/test_resources/crypto_gifts.png") + + let bullet2 = Bullet() + bullet2.bulletType = .unicode + bullet2.unicode = "1f44d" + + let bulletPoint21 = BulletPoint() + bulletPoint21.bullet = bullet2 + bulletPoint21.titleText = "Vestibulum" + bulletPoint21.subTitleText = "Etiam porta sem malesuada magna mollis euismod." + + let bulletPoint22 = BulletPoint() + bulletPoint22.bullet = bullet2 + bulletPoint22.titleText = "Justo Condimentum" + bulletPoint22.subTitleText = "Sed posuere consectetur est at lobortis. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor." + + let actionButton = ActionButton() + actionButton.title = "Take me to Crypto Gifts" + + // Create Items List + let bulletItems2 = [title2, message2, actionButton,media, bulletPoint21]// [title2, message2, bulletPoint21, bulletPoint22] + + // Register Item + dataStore.registerVersionInfo(version: version, items: bulletItems2) + } + + @IBAction func bulletinButtonTapped(_ sender: Any) { + + // Creage DataStore Object + let dataSource = BulletinDataStore() + + // Register Multiple Versions + registerBulletingDetails(forVersion: Version("1.11"), inDataStore: dataSource) + registerBulletingDetails(forVersion: Version("1.12"), inDataStore: dataSource) + + let sdk = BulletinSDK(dataStore: dataSource,appearance: Appearance.darkKnight) + let bulletinVC = sdk.getFullBulletin() + + // Get Top Most View Controller + BulletinHelper.topMostViewController { (topMostVC) in + + // Validation + guard let topMostVC = topMostVC else { + return + } + + guard let bulletinVC = bulletinVC else { + return + } + + bulletinVC.delegate = self + + bulletinVC.loadViewIfNeeded() + bulletinVC.reload(animated: false,completion: {_ in + // Display Bulletin PopUp VC + let segue = AlertSegue(identifier: nil, source: topMostVC, destination: bulletinVC) + topMostVC.prepare(for: segue, sender: nil) + segue.perform() + }) + } + + } + +} + +//// MARK: - WZSettingsSectionControllerDelegate +extension ViewController: BulletinListDelegate { + + func BulletinList(didClickItem item: BulletinItem) { + + // Validation + if let actionButtonItem = item as? ActionButton, + let actionButtonPayload = actionButtonItem.clickPayload { + print(actionButtonPayload) + } + + } + +} + diff --git a/Demo/Podfile b/Demo/Podfile new file mode 100644 index 0000000..05ac606 --- /dev/null +++ b/Demo/Podfile @@ -0,0 +1,13 @@ +# Uncomment the next line to define a global platform for your project +# platform :ios, '9.0' + +target 'Bulletin' do + # Comment the next line if you don't want to use dynamic frameworks + use_frameworks! + + # Pods for Bulletin + pod 'UIColor_Hex_Swift' + pod 'IGListKit' + pod 'Kingfisher','~> 7.6.2' + pod 'SwiftMessages' +end diff --git a/Demo/Podfile.lock b/Demo/Podfile.lock new file mode 100644 index 0000000..8a29c14 --- /dev/null +++ b/Demo/Podfile.lock @@ -0,0 +1,34 @@ +PODS: + - IGListDiffKit (4.0.0) + - IGListKit (4.0.0): + - IGListDiffKit (= 4.0.0) + - Kingfisher (7.6.2) + - SwiftMessages (9.0.6): + - SwiftMessages/App (= 9.0.6) + - SwiftMessages/App (9.0.6) + - UIColor_Hex_Swift (5.1.7) + +DEPENDENCIES: + - IGListKit + - Kingfisher (~> 7.6.2) + - SwiftMessages + - UIColor_Hex_Swift + +SPEC REPOS: + trunk: + - IGListDiffKit + - IGListKit + - Kingfisher + - SwiftMessages + - UIColor_Hex_Swift + +SPEC CHECKSUMS: + IGListDiffKit: 665d6cf43ce726e676013db9c7d6c4294259b6b2 + IGListKit: fd5a5d21935298f5849fa49d426843cff97b77c7 + Kingfisher: 6c5449c6450c5239166510ba04afe374a98afc4f + SwiftMessages: f0c7ef4705a570ad6c5e208b611f4333e660ed92 + UIColor_Hex_Swift: 31cd3e47440f07a20d2503a36bb0437a445b3c29 + +PODFILE CHECKSUM: 310645f0fa108e1099503961f2d58481962552ed + +COCOAPODS: 1.12.1 diff --git a/Demo/Pods/IGListDiffKit/LICENSE.md b/Demo/Pods/IGListDiffKit/LICENSE.md new file mode 100755 index 0000000..87cbf53 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/LICENSE.md @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) Facebook, Inc. and its affiliates. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/Demo/Pods/IGListDiffKit/README.md b/Demo/Pods/IGListDiffKit/README.md new file mode 100644 index 0000000..22981eb --- /dev/null +++ b/Demo/Pods/IGListDiffKit/README.md @@ -0,0 +1,110 @@ +

+ +

+ +

+ + Build Status + + + Coverage Status + + + Pods Version + + + Platforms + + + Carthage Compatible + +

+ +---------------- + +A data-driven `UICollectionView` framework for building fast and flexible lists. + +| | Main Features | +----------|----------------- +🙅 | Never call `performBatchUpdates(_:, completion:)` or `reloadData()` again +🏠 | Better architecture with reusable cells and components +🔠 | Create collections with multiple data types +🔑 | Decoupled diffing algorithm +✅ | Fully unit tested +🔍 | Customize your diffing behavior for your models +📱 | Simply `UICollectionView` at its core +🚀 | Extendable API +🐦 | Written in Objective-C with full Swift interop support + +`IGListKit` is built and maintained with ❤️ by [Instagram engineering](https://engineering.instagram.com/). +We use the open source version `master` branch in the Instagram app. + +## Requirements + +- Xcode 9.0+ +- iOS 9.0+ +- tvOS 9.0+ +- macOS 10.11+ *(diffing algorithm components only)* +- Interoperability with Swift 3.0+ + +## Installation + +### CocoaPods + +The preferred installation method is with [CocoaPods](https://cocoapods.org). Add the following to your `Podfile`: + +```ruby +pod 'IGListKit', '~> 4.0.0' +``` + +### Carthage + +For [Carthage](https://github.com/Carthage/Carthage), add the following to your `Cartfile`: + +```ogdl +github "Instagram/IGListKit" ~> 4.0.0 +``` + +> For advanced usage, see our [Installation Guide](https://instagram.github.io/IGListKit/installation.html). + +## Getting Started + +```bash +$ git clone https://github.com/Instagram/IGListKit.git +$ cd IGListKit/ +$ ./scripts/setup.sh +``` + +- Our [Getting Started guide](https://instagram.github.io/IGListKit/getting-started.html) +- Ray Wenderlich's [IGListKit Tutorial: Better UICollectionViews](https://www.raywenderlich.com/147162/iglistkit-tutorial-better-uicollectionviews) +- Our [example projects](https://github.com/Instagram/IGListKit/tree/master/Examples) +- Ryan Nystrom's [talk at try! Swift NYC](https://realm.io/news/tryswift-ryan-nystrom-refactoring-at-scale-lessons-learned-rewriting-instagram-feed/) (Note: this talk was for an earlier version. Some APIs have changed.) +- [Migrating an UITableView to IGListCollectionView](https://medium.com/cocoaacademymag/iglistkit-migrating-an-uitableview-to-iglistkitcollectionview-65a30cf9bac9), by Rodrigo Cavalcante +- [Keeping data fresh in Buffer for iOS with AsyncDisplayKit, IGListKit & Pusher](https://overflow.buffer.com/2017/04/10/keeping-data-fresh-buffer-ios-asyncdisplaykit-iglistkit-pusher/), Andy Yates, Buffer + +## Documentation + +You can find [the docs here](https://instagram.github.io/IGListKit). Documentation is generated with [jazzy](https://github.com/realm/jazzy) and hosted on [GitHub-Pages](https://pages.github.com). + +To regenerate docs, run `./scripts/build_docs.sh` from the root directory in the repo. + +## Vision + +For the long-term goals and "vision" of `IGListKit`, please read our [Vision](https://github.com/Instagram/IGListKit/blob/master/Guides/VISION.md) doc. + +## Contributing + +Please see the [CONTRIBUTING](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md) file for how to help. At Instagram, we sync the open source version of `IGListKit` daily, so we're always testing the latest changes. But that requires all changes be thoroughly tested and follow our style guide. + +We have a set of [starter tasks](https://github.com/Instagram/IGListKit/issues?q=is%3Aissue+is%3Aopen+label%3Astarter-task) that are great for beginners to jump in on and start contributing. + +## License + +`IGListKit` is [MIT-licensed](./LICENSE). + +The files in the `/Examples/` directory are licensed under a separate license as specified in each file. Documentation is licensed [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/). diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListAssert.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListAssert.h new file mode 100644 index 0000000..97466e2 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListAssert.h @@ -0,0 +1,22 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#ifndef IGAssert +#define IGAssert( condition, ... ) NSCAssert( (condition) , ##__VA_ARGS__) +#endif // IGAssert + +#ifndef IGFailAssert +#define IGFailAssert( ... ) IGAssert( (NO) , ##__VA_ARGS__) +#endif // IGFailAssert + +#ifndef IGParameterAssert +#define IGParameterAssert( condition ) IGAssert( (condition) , @"Invalid parameter not satisfying: %@", @#condition) +#endif // IGParameterAssert + +#ifndef IGAssertMainThread +#define IGAssertMainThread() IGAssert( ([NSThread isMainThread] == YES), @"Must be on the main thread") +#endif // IGAssertMainThread diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListBatchUpdateData.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListBatchUpdateData.h new file mode 100644 index 0000000..4482d9b --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListBatchUpdateData.h @@ -0,0 +1,106 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + An instance of `IGListBatchUpdateData` takes section indexes and item index paths + and performs cleanup on init in order to perform a crash-free + update via `-[UICollectionView performBatchUpdates:completion:]`. + */ +IGLK_SUBCLASSING_RESTRICTED +NS_SWIFT_NAME(ListBatchUpdateData) +@interface IGListBatchUpdateData : NSObject + +/** + Section insert indexes. + */ +@property (nonatomic, strong, readonly) NSIndexSet *insertSections; + +/** + Section delete indexes. + */ +@property (nonatomic, strong, readonly) NSIndexSet *deleteSections; + +/** + Section moves. + */ +@property (nonatomic, strong, readonly) NSSet *moveSections; + +/** + Item insert index paths. + */ +@property (nonatomic, strong, readonly) NSArray *insertIndexPaths; + +/** + Item delete index paths. + */ +@property (nonatomic, strong, readonly) NSArray *deleteIndexPaths; + +/** + Item update index paths. + */ +@property (nonatomic, strong, readonly) NSArray *updateIndexPaths; + +/** + Item moves. + */ +@property (nonatomic, strong, readonly) NSArray *moveIndexPaths; + +/** + Creates a new batch update object with section and item operations. + + @param insertSections Section indexes to insert. + @param deleteSections Section indexes to delete. + @param moveSections Section moves. + @param insertIndexPaths Item index paths to insert. + @param deleteIndexPaths Item index paths to delete. + @param updateIndexPaths Item index paths to update. + @param moveIndexPaths Item index paths to move. + @param fixIndexPathImbalance When enabled, we remove duplicate NSIndexPath inserts to avoid insert/delete imbalance and a crash. + + @return A new batch update object. + */ +- (instancetype)initWithInsertSections:(NSIndexSet *)insertSections + deleteSections:(NSIndexSet *)deleteSections + moveSections:(NSSet *)moveSections + insertIndexPaths:(NSArray *)insertIndexPaths + deleteIndexPaths:(NSArray *)deleteIndexPaths + updateIndexPaths:(NSArray *)updateIndexPaths + moveIndexPaths:(NSArray *)moveIndexPaths + fixIndexPathImbalance:(BOOL)fixIndexPathImbalance NS_DESIGNATED_INITIALIZER; + +/** + Convenience initializer with fixIndexPathImbalance disabled. + */ +- (instancetype)initWithInsertSections:(NSIndexSet *)insertSections + deleteSections:(NSIndexSet *)deleteSections + moveSections:(NSSet *)moveSections + insertIndexPaths:(NSArray *)insertIndexPaths + deleteIndexPaths:(NSArray *)deleteIndexPaths + updateIndexPaths:(NSArray *)updateIndexPaths + moveIndexPaths:(NSArray *)moveIndexPaths; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListBatchUpdateData.mm b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListBatchUpdateData.mm new file mode 100644 index 0000000..7bdf32b --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListBatchUpdateData.mm @@ -0,0 +1,179 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListBatchUpdateData.h" + +#import + +#import +#import + +// Plucks the given move from available moves and turns it into a delete + insert +static void convertMoveToDeleteAndInsert(NSMutableSet *moves, + IGListMoveIndex *move, + NSMutableIndexSet *deletes, + NSMutableIndexSet *inserts) { + [moves removeObject:move]; + + // add a delete and insert respecting the move's from and to sections + // delete + insert will result in reloading the entire section + [deletes addIndex:move.from]; + [inserts addIndex:move.to]; +} + +@implementation IGListBatchUpdateData + +// Converts all section moves that have index path operations into a section delete + insert. ++ (void)_cleanIndexPathsWithMap:(const std::unordered_map &)map + moves:(NSMutableSet *)moves + indexPaths:(NSMutableArray *)indexPaths + deletes:(NSMutableIndexSet *)deletes + inserts:(NSMutableIndexSet *)inserts { + for (NSInteger i = indexPaths.count - 1; i >= 0; i--) { + NSIndexPath *path = indexPaths[i]; + const auto it = map.find(path.section); + if (it != map.end() && it->second != nil) { + [indexPaths removeObjectAtIndex:i]; + convertMoveToDeleteAndInsert(moves, it->second, deletes, inserts); + } + } +} + +- (instancetype)initWithInsertSections:(NSIndexSet *)insertSections + deleteSections:(NSIndexSet *)deleteSections + moveSections:(NSSet *)moveSections + insertIndexPaths:(NSArray *)insertIndexPaths + deleteIndexPaths:(NSArray *)deleteIndexPaths + updateIndexPaths:(NSArray *)updateIndexPaths + moveIndexPaths:(NSArray *)moveIndexPaths { + return [self initWithInsertSections:insertSections + deleteSections:deleteSections + moveSections:moveSections + insertIndexPaths:insertIndexPaths + deleteIndexPaths:deleteIndexPaths + updateIndexPaths:updateIndexPaths + moveIndexPaths:moveIndexPaths + fixIndexPathImbalance:NO]; +} + +/** + Converts all section moves that are also reloaded, or have index path inserts, deletes, or reloads into a section + delete + insert in order to avoid UICollectionView heap corruptions, exceptions, and animation/snapshot bugs. + */ +- (instancetype)initWithInsertSections:(nonnull NSIndexSet *)insertSections + deleteSections:(nonnull NSIndexSet *)deleteSections + moveSections:(nonnull NSSet *)moveSections + insertIndexPaths:(nonnull NSArray *)insertIndexPaths + deleteIndexPaths:(nonnull NSArray *)deleteIndexPaths + updateIndexPaths:(nonnull NSArray *)updateIndexPaths + moveIndexPaths:(nonnull NSArray *)moveIndexPaths + fixIndexPathImbalance:(BOOL)fixIndexPathImbalance { + IGParameterAssert(insertSections != nil); + IGParameterAssert(deleteSections != nil); + IGParameterAssert(moveSections != nil); + IGParameterAssert(insertIndexPaths != nil); + IGParameterAssert(deleteIndexPaths != nil); + IGParameterAssert(updateIndexPaths != nil); + IGParameterAssert(moveIndexPaths != nil); + if (self = [super init]) { + NSMutableSet *mMoveSections = [moveSections mutableCopy]; + NSMutableIndexSet *mDeleteSections = [deleteSections mutableCopy]; + NSMutableIndexSet *mInsertSections = [insertSections mutableCopy]; + NSMutableSet *mMoveIndexPaths = [moveIndexPaths mutableCopy]; + + // these collections should NEVER be mutated during cleanup passes, otherwise sections that have multiple item + // changes (e.g. a moved section that has a delete + reload on different index paths w/in the section) will only + // convert one of the item changes into a section delete+insert. this will fail hard and be VERY difficult to + // debug + const NSInteger moveCount = [moveSections count]; + std::unordered_map fromMap(moveCount); + std::unordered_map toMap(moveCount); + for (IGListMoveIndex *move in moveSections) { + const NSInteger from = move.from; + const NSInteger to = move.to; + + // if the move is already deleted or inserted, discard it because count-changing operations must match + // with data source changes + if ([deleteSections containsIndex:from] || [insertSections containsIndex:to]) { + [mMoveSections removeObject:move]; + } else { + fromMap[from] = move; + toMap[to] = move; + } + } + + // avoid a flaky UICollectionView bug when deleting from the same index path twice + // exposes a possible data source inconsistency issue + NSMutableArray *mDeleteIndexPaths = [[[NSSet setWithArray:deleteIndexPaths] allObjects] mutableCopy]; + + NSMutableArray *mInsertIndexPaths; + if (fixIndexPathImbalance) { + // Since we remove duplicate deletes (see above) we also need to remove inserts to keep the same insert/delete + // balance. For example, if we reload (insert & delete) the same NSIndexPath twice, we would otherwise end up + // with 2 inserts and 1 delete. + mInsertIndexPaths = [[[NSSet setWithArray:insertIndexPaths] allObjects] mutableCopy]; + } else { + mInsertIndexPaths = [insertIndexPaths mutableCopy]; + } + + // avoids a bug where a cell is animated twice and one of the snapshot cells is never removed from the hierarchy + [IGListBatchUpdateData _cleanIndexPathsWithMap:fromMap moves:mMoveSections indexPaths:mDeleteIndexPaths deletes:mDeleteSections inserts:mInsertSections]; + + // prevents a bug where UICollectionView corrupts the heap memory when inserting into a section that is moved + [IGListBatchUpdateData _cleanIndexPathsWithMap:toMap moves:mMoveSections indexPaths:mInsertIndexPaths deletes:mDeleteSections inserts:mInsertSections]; + + for (IGListMoveIndexPath *move in moveIndexPaths) { + // if the section w/ an index path move is deleted, just drop the move + if ([deleteSections containsIndex:move.from.section]) { + [mMoveIndexPaths removeObject:move]; + } + + // if a move is inside a section that is moved, convert the section move to a delete+insert + const auto it = fromMap.find(move.from.section); + if (it != fromMap.end() && it->second != nil) { + IGListMoveIndex *sectionMove = it->second; + [mMoveIndexPaths removeObject:move]; + [mMoveSections removeObject:sectionMove]; + [mDeleteSections addIndex:sectionMove.from]; + [mInsertSections addIndex:sectionMove.to]; + } + } + + _deleteSections = [mDeleteSections copy]; + _insertSections = [mInsertSections copy]; + _moveSections = [mMoveSections copy]; + _deleteIndexPaths = [mDeleteIndexPaths copy]; + _insertIndexPaths = [mInsertIndexPaths copy]; + _updateIndexPaths = [updateIndexPaths copy]; + _moveIndexPaths = [mMoveIndexPaths copy]; + } + return self; +} + +- (BOOL)isEqual:(id)object { + if (object == self) { + return YES; + } + if ([object isKindOfClass:[IGListBatchUpdateData class]]) { + return ([self.insertSections isEqual:[object insertSections]] + && [self.deleteSections isEqual:[object deleteSections]] + && [self.moveSections isEqual:[object moveSections]] + && [self.insertIndexPaths isEqual:[object insertIndexPaths]] + && [self.deleteIndexPaths isEqual:[object deleteIndexPaths]] + && [self.updateIndexPaths isEqual:[object updateIndexPaths]] + && [self.moveIndexPaths isEqual:[object moveIndexPaths]]); + } + return NO; +} + +- (NSString *)description { + return [NSString stringWithFormat:@"<%@ %p; deleteSections: %lu; insertSections: %lu; moveSections: %lu; deleteIndexPaths: %lu; insertIndexPaths: %lu; updateIndexPaths: %lu>", + NSStringFromClass(self.class), self, (unsigned long)self.deleteSections.count, (unsigned long)self.insertSections.count, (unsigned long)self.moveSections.count, + (unsigned long)self.deleteIndexPaths.count, (unsigned long)self.insertIndexPaths.count, (unsigned long)self.updateIndexPaths.count]; +} + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListCompatibility.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListCompatibility.h new file mode 100644 index 0000000..e9d9726 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListCompatibility.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#if TARGET_OS_EMBEDDED || TARGET_OS_SIMULATOR +#import +#else +#import +#endif diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiff.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiff.h new file mode 100644 index 0000000..91fa26b --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiff.h @@ -0,0 +1,63 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + An option for how to do comparisons between similar objects. + */ +NS_SWIFT_NAME(ListDiffOption) +typedef NS_ENUM(NSInteger, IGListDiffOption) { + /** + Compare objects using pointer personality. + */ + IGListDiffPointerPersonality, + /** + Compare objects using `-[IGListDiffable isEqualToDiffableObject:]`. + */ + IGListDiffEquality +}; + +/** + Creates a diff using indexes between two collections. + + @param oldArray The old objects to diff against. + @param newArray The new objects. + @param option An option on how to compare objects. + + @return A result object containing affected indexes. + */ +NS_SWIFT_NAME(ListDiff(oldArray:newArray:option:)) +FOUNDATION_EXTERN IGListIndexSetResult *IGListDiff(NSArray> *_Nullable oldArray, + NSArray> *_Nullable newArray, + IGListDiffOption option); + +/** + Creates a diff using index paths between two collections. + + @param fromSection The old section. + @param toSection The new section. + @param oldArray The old objects to diff against. + @param newArray The new objects. + @param option An option on how to compare objects. + + @return A result object containing affected indexes. + */ +NS_SWIFT_NAME(ListDiffPaths(fromSection:toSection:oldArray:newArray:option:)) +FOUNDATION_EXTERN IGListIndexPathResult *IGListDiffPaths(NSInteger fromSection, + NSInteger toSection, + NSArray> *_Nullable oldArray, + NSArray> *_Nullable newArray, + IGListDiffOption option); + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiff.mm b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiff.mm new file mode 100644 index 0000000..12ccc02 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiff.mm @@ -0,0 +1,348 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListDiff.h" + +#import +#import +#import + +#import +#import + +#import "IGListIndexPathResultInternal.h" +#import "IGListIndexSetResultInternal.h" +#import "IGListMoveIndexInternal.h" +#import "IGListMoveIndexPathInternal.h" + +using namespace std; + +/// Used to track data stats while diffing. +struct IGListEntry { + /// The number of times the data occurs in the old array + NSInteger oldCounter = 0; + /// The number of times the data occurs in the new array + NSInteger newCounter = 0; + /// The indexes of the data in the old array + stack oldIndexes; + /// Flag marking if the data has been updated between arrays by checking the isEqual: method + BOOL updated = NO; +}; + +/// Track both the entry and algorithm index. Default the index to NSNotFound +struct IGListRecord { + IGListEntry *entry; + mutable NSInteger index; + + IGListRecord() { + entry = NULL; + index = NSNotFound; + } +}; + +static id IGListTableKey(__unsafe_unretained id object) { + id key = [object diffIdentifier]; + NSCAssert(key != nil, @"Cannot use a nil key for the diffIdentifier of object %@", object); + return key; +} + +struct IGListEqualID { + bool operator()(const id a, const id b) const { + return (a == b) || [a isEqual: b]; + } +}; + +struct IGListHashID { + size_t operator()(const id o) const { + return (size_t)[o hash]; + } +}; + +static void addIndexToMap(BOOL useIndexPaths, NSInteger section, NSInteger index, __unsafe_unretained id object, __unsafe_unretained NSMapTable *map) { + id value; + if (useIndexPaths) { + value = [NSIndexPath indexPathForItem:index inSection:section]; + } else { + value = @(index); + } + [map setObject:value forKey:[object diffIdentifier]]; +} + +static void addIndexToCollection(BOOL useIndexPaths, __unsafe_unretained id collection, NSInteger section, NSInteger index) { + if (useIndexPaths) { + NSIndexPath *path = [NSIndexPath indexPathForItem:index inSection:section]; + [collection addObject:path]; + } else { + [collection addIndex:index]; + } +}; + +static NSArray *indexPathsAndPopulateMap(__unsafe_unretained NSArray> *array, NSInteger section, __unsafe_unretained NSMapTable *map) { + NSMutableArray *paths = [NSMutableArray new]; + [array enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) { + NSIndexPath *path = [NSIndexPath indexPathForItem:idx inSection:section]; + [paths addObject:path]; + [map setObject:path forKey:[obj diffIdentifier]]; + }]; + return paths; +} + +static id IGListDiffing(BOOL returnIndexPaths, + NSInteger fromSection, + NSInteger toSection, + NSArray> *oldArray, + NSArray> *newArray, + IGListDiffOption option, + IGListExperiment experiments) { + const NSInteger newCount = newArray.count; + const NSInteger oldCount = oldArray.count; + + NSMapTable *oldMap = [NSMapTable strongToStrongObjectsMapTable]; + NSMapTable *newMap = [NSMapTable strongToStrongObjectsMapTable]; + + // if no new objects, everything from the oldArray is deleted + // take a shortcut and just build a delete-everything result + if (newCount == 0) { + if (returnIndexPaths) { + return [[IGListIndexPathResult alloc] initWithInserts:[NSArray new] + deletes:indexPathsAndPopulateMap(oldArray, fromSection, oldMap) + updates:[NSArray new] + moves:[NSArray new] + oldIndexPathMap:oldMap + newIndexPathMap:newMap]; + } else { + [oldArray enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) { + addIndexToMap(returnIndexPaths, fromSection, idx, obj, oldMap); + }]; + return [[IGListIndexSetResult alloc] initWithInserts:[NSIndexSet new] + deletes:[NSIndexSet indexSetWithIndexesInRange:NSMakeRange(0, oldCount)] + updates:[NSIndexSet new] + moves:[NSArray new] + oldIndexMap:oldMap + newIndexMap:newMap]; + } + } + + // if no old objects, everything from the newArray is inserted + // take a shortcut and just build an insert-everything result + if (oldCount == 0) { + if (returnIndexPaths) { + return [[IGListIndexPathResult alloc] initWithInserts:indexPathsAndPopulateMap(newArray, toSection, newMap) + deletes:[NSArray new] + updates:[NSArray new] + moves:[NSArray new] + oldIndexPathMap:oldMap + newIndexPathMap:newMap]; + } else { + [newArray enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) { + addIndexToMap(returnIndexPaths, toSection, idx, obj, newMap); + }]; + return [[IGListIndexSetResult alloc] initWithInserts:[NSIndexSet indexSetWithIndexesInRange:NSMakeRange(0, newCount)] + deletes:[NSIndexSet new] + updates:[NSIndexSet new] + moves:[NSArray new] + oldIndexMap:oldMap + newIndexMap:newMap]; + } + } + + // symbol table uses the old/new array diffIdentifier as the key and IGListEntry as the value + // using id as the key provided by https://lists.gnu.org/archive/html/discuss-gnustep/2011-07/msg00019.html + unordered_map, IGListEntry, IGListHashID, IGListEqualID> table; + + // pass 1 + // create an entry for every item in the new array + // increment its new count for each occurence + vector newResultsArray(newCount); + for (NSInteger i = 0; i < newCount; i++) { + id key = IGListTableKey(newArray[i]); + IGListEntry &entry = table[key]; + entry.newCounter++; + + // add NSNotFound for each occurence of the item in the new array + entry.oldIndexes.push(NSNotFound); + + // note: the entry is just a pointer to the entry which is stack-allocated in the table + newResultsArray[i].entry = &entry; + } + + // pass 2 + // update or create an entry for every item in the old array + // increment its old count for each occurence + // record the original index of the item in the old array + // MUST be done in descending order to respect the oldIndexes stack construction + vector oldResultsArray(oldCount); + for (NSInteger i = oldCount - 1; i >= 0; i--) { + id key = IGListTableKey(oldArray[i]); + IGListEntry &entry = table[key]; + entry.oldCounter++; + + // push the original indices where the item occurred onto the index stack + entry.oldIndexes.push(i); + + // note: the entry is just a pointer to the entry which is stack-allocated in the table + oldResultsArray[i].entry = &entry; + } + + // pass 3 + // handle data that occurs in both arrays + for (NSInteger i = 0; i < newCount; i++) { + IGListEntry *entry = newResultsArray[i].entry; + + // grab and pop the top original index. if the item was inserted this will be NSNotFound + NSCAssert(!entry->oldIndexes.empty(), @"Old indexes is empty while iterating new item %li. Should have NSNotFound", (long)i); + const NSInteger originalIndex = entry->oldIndexes.top(); + entry->oldIndexes.pop(); + + if (originalIndex < oldCount) { + const id n = newArray[i]; + const id o = oldArray[originalIndex]; + switch (option) { + case IGListDiffPointerPersonality: + // flag the entry as updated if the pointers are not the same + if (n != o) { + entry->updated = YES; + } + break; + case IGListDiffEquality: + // use -[IGListDiffable isEqualToDiffableObject:] between both version of data to see if anything has changed + // skip the equality check if both indexes point to the same object + if (n != o && ![n isEqualToDiffableObject:o]) { + entry->updated = YES; + } + break; + } + } + if (originalIndex != NSNotFound + && entry->newCounter > 0 + && entry->oldCounter > 0) { + // if an item occurs in the new and old array, it is unique + // assign the index of new and old records to the opposite index (reverse lookup) + newResultsArray[i].index = originalIndex; + oldResultsArray[originalIndex].index = i; + } + } + + // storage for final NSIndexPaths or indexes + id mInserts, mMoves, mUpdates, mDeletes; + if (returnIndexPaths) { + mInserts = [NSMutableArray new]; + mMoves = [NSMutableArray new]; + mUpdates = [NSMutableArray new]; + mDeletes = [NSMutableArray new]; + } else { + mInserts = [NSMutableIndexSet new]; + mMoves = [NSMutableArray new]; + mUpdates = [NSMutableIndexSet new]; + mDeletes = [NSMutableIndexSet new]; + } + + // track offsets from deleted items to calculate where items have moved + vector deleteOffsets(oldCount), insertOffsets(newCount); + NSInteger runningOffset = 0; + + // iterate old array records checking for deletes + // incremement offset for each delete + for (NSInteger i = 0; i < oldCount; i++) { + deleteOffsets[i] = runningOffset; + const IGListRecord record = oldResultsArray[i]; + // if the record index in the new array doesn't exist, its a delete + if (record.index == NSNotFound) { + addIndexToCollection(returnIndexPaths, mDeletes, fromSection, i); + runningOffset++; + } + + addIndexToMap(returnIndexPaths, fromSection, i, oldArray[i], oldMap); + } + + // reset and track offsets from inserted items to calculate where items have moved + runningOffset = 0; + + for (NSInteger i = 0; i < newCount; i++) { + insertOffsets[i] = runningOffset; + const IGListRecord record = newResultsArray[i]; + const NSInteger oldIndex = record.index; + // add to inserts if the opposing index is NSNotFound + if (record.index == NSNotFound) { + addIndexToCollection(returnIndexPaths, mInserts, toSection, i); + runningOffset++; + } else { + // note that an entry can be updated /and/ moved + if (record.entry->updated) { + addIndexToCollection(returnIndexPaths, mUpdates, fromSection, oldIndex); + } + + // calculate the offset and determine if there was a move + // if the indexes match, ignore the index + const NSInteger insertOffset = insertOffsets[i]; + const NSInteger deleteOffset = deleteOffsets[oldIndex]; + if ((oldIndex - deleteOffset + insertOffset) != i) { + id move; + if (returnIndexPaths) { + NSIndexPath *from = [NSIndexPath indexPathForItem:oldIndex inSection:fromSection]; + NSIndexPath *to = [NSIndexPath indexPathForItem:i inSection:toSection]; + move = [[IGListMoveIndexPath alloc] initWithFrom:from to:to]; + } else { + move = [[IGListMoveIndex alloc] initWithFrom:oldIndex to:i]; + } + [mMoves addObject:move]; + } + } + + addIndexToMap(returnIndexPaths, toSection, i, newArray[i], newMap); + } + + NSCAssert((oldCount + [mInserts count] - [mDeletes count]) == newCount, + @"Sanity check failed applying %lu inserts and %lu deletes to old count %li equaling new count %li", + (unsigned long)[mInserts count], (unsigned long)[mDeletes count], (long)oldCount, (long)newCount); + + if (returnIndexPaths) { + return [[IGListIndexPathResult alloc] initWithInserts:mInserts + deletes:mDeletes + updates:mUpdates + moves:mMoves + oldIndexPathMap:oldMap + newIndexPathMap:newMap]; + } else { + return [[IGListIndexSetResult alloc] initWithInserts:mInserts + deletes:mDeletes + updates:mUpdates + moves:mMoves + oldIndexMap:oldMap + newIndexMap:newMap]; + } +} + +IGListIndexSetResult *IGListDiff(NSArray > *oldArray, + NSArray> *newArray, + IGListDiffOption option) { + return IGListDiffing(NO, 0, 0, oldArray, newArray, option, 0); +} + +IGListIndexPathResult *IGListDiffPaths(NSInteger fromSection, + NSInteger toSection, + NSArray> *oldArray, + NSArray> *newArray, + IGListDiffOption option) { + return IGListDiffing(YES, fromSection, toSection, oldArray, newArray, option, 0); +} + +IGListIndexSetResult *IGListDiffExperiment(NSArray> *_Nullable oldArray, + NSArray> *_Nullable newArray, + IGListDiffOption option, + IGListExperiment experiments) { + return IGListDiffing(NO, 0, 0, oldArray, newArray, option, experiments); +} + +IGListIndexPathResult *IGListDiffPathsExperiment(NSInteger fromSection, + NSInteger toSection, + NSArray> *_Nullable oldArray, + NSArray> *_Nullable newArray, + IGListDiffOption option, + IGListExperiment experiments) { + return IGListDiffing(YES, fromSection, toSection, oldArray, newArray, option, experiments); +} diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiffKit.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiffKit.h new file mode 100644 index 0000000..d889ba3 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiffKit.h @@ -0,0 +1,30 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +/** + * Project version number for IGListKit. + */ +FOUNDATION_EXPORT double IGListKitVersionNumber; + +/** + * Project version string for IGListKit. + */ +FOUNDATION_EXPORT const unsigned char IGListKitVersionString[]; + +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiffable.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiffable.h new file mode 100644 index 0000000..5875daf --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListDiffable.h @@ -0,0 +1,38 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +/** + The `IGListDiffable` protocol provides methods needed to compare the identity and equality of two objects. + */ +NS_SWIFT_NAME(ListDiffable) +@protocol IGListDiffable + +/** + Returns a key that uniquely identifies the object. + + @return A key that can be used to uniquely identify the object. + + @note Two objects may share the same identifier, but are not equal. A common pattern is to use the `NSObject` + category for automatic conformance. However this means that objects will be identified on their + pointer value so finding updates becomes impossible. + + @warning This value should never be mutated. + */ +- (nonnull id)diffIdentifier; + +/** + Returns whether the receiver and a given object are equal. + + @param object The object to be compared to the receiver. + + @return `YES` if the receiver and object are equal, otherwise `NO`. + */ +- (BOOL)isEqualToDiffableObject:(nullable id)object; + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListExperiments.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListExperiments.h new file mode 100644 index 0000000..009f3df --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListExperiments.h @@ -0,0 +1,92 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +/** + Bitmask-able options used for pre-release feature testing. + */ +NS_SWIFT_NAME(ListExperiment) +typedef NS_OPTIONS (NSInteger, IGListExperiment) { + /// Specifies no experiments. + IGListExperimentNone = 1 << 1, + /// Test updater diffing performed on a background queue. + IGListExperimentBackgroundDiffing = 1 << 2, + /// Test fallback to reloadData when "too many" update operations. + IGListExperimentReloadDataFallback = 1 << 3, + /// Test removing the layout pass when calling scrollToObject to avoid creating off-screen cells. + IGListExperimentAvoidLayoutOnScrollToObject = 1 << 4, + /// Test fixing a crash when inserting and deleting the same NSIndexPath multiple times. + IGListExperimentFixIndexPathImbalance = 1 << 5, + /// Test deferring object creation until just before diffing. + IGListExperimentDeferredToObjectCreation = 1 << 6, + /// Test getting collection view at update time. + IGListExperimentGetCollectionViewAtUpdate = 1 << 7, + /// Test invalidating layout when cell reloads/updates in IGListBindingSectionController. + IGListExperimentInvalidateLayoutForUpdates = 1 << 8, + /// Test using the collection view when asking for layout instead of accessing the data source. Only apply to IGListCollectionViewLayout. + IGListExperimentUseCollectionViewInsteadOfDataSourceInLayout = 1 << 9 +}; + +/** + Check if an experiment is enabled in a bitmask. + + @param mask The bitmask of experiments. + @param option The option to compare with. + + @return `YES` if the option is in the bitmask, otherwise `NO`. + */ +NS_SWIFT_NAME(ListExperimentEnabled(mask:option:)) +static inline BOOL IGListExperimentEnabled(IGListExperiment mask, IGListExperiment option) { + return (mask & option) != 0; +} + +NS_ASSUME_NONNULL_BEGIN + +/** + Performs an index diff with an experiment bitmask. + + @param oldArray The old array of objects. + @param newArray The new array of objects. + @param option Option to specify the type of diff. + @param experiments Optional experiments. + + @return An index set result object contained the changed indexes. + + @see `IGListDiff()`. + */ +NS_SWIFT_NAME(ListDiffExperiment(oldArray:newArray:option:experiments:)) +FOUNDATION_EXTERN IGListIndexSetResult *IGListDiffExperiment(NSArray> *_Nullable oldArray, + NSArray> *_Nullable newArray, + IGListDiffOption option, + IGListExperiment experiments); + +/** + Performs a index path diff with an experiment bitmask. + + @param fromSection The old section. + @param toSection The new section. + @param oldArray The old array of objects. + @param newArray The new array of objects. + @param option Option to specify the type of diff. + @param experiments Optional experiments. + + @return An index path result object containing the changed indexPaths. + + @see `IGListDiffPaths()`. + */ +NS_SWIFT_NAME(ListDiffPathsExperiment(fromSection:toSection:oldArray:newArray:option:experiments:)) +FOUNDATION_EXTERN IGListIndexPathResult *IGListDiffPathsExperiment(NSInteger fromSection, + NSInteger toSection, + NSArray> *_Nullable oldArray, + NSArray> *_Nullable newArray, + IGListDiffOption option, + IGListExperiment experiments); + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexPathResult.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexPathResult.h new file mode 100644 index 0000000..d0baedb --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexPathResult.h @@ -0,0 +1,85 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + A result object returned when diffing with sections. + */ +NS_SWIFT_NAME(ListIndexPathResult) +@interface IGListIndexPathResult : NSObject + +/** + The index paths inserted into the new collection. + */ +@property (nonatomic, copy, readonly) NSArray *inserts; + +/** + The index paths deleted from the old collection. + */ +@property (nonatomic, copy, readonly) NSArray *deletes; + +/** + The index paths in the old collection that need updated. + */ +@property (nonatomic, copy, readonly) NSArray *updates; + +/** + The moves from an index path in the old collection to an index path in the new collection. + */ +@property (nonatomic, copy, readonly) NSArray *moves; + +/** + A Read-only boolean that indicates whether the result has any changes or not. + `YES` if the result has changes, `NO` otherwise. + */ +@property (nonatomic, assign, readonly) BOOL hasChanges; + +/** + Returns the index path of the object with the specified identifier *before* the diff. + + @param identifier The diff identifier of the object. + + @return The index path of the object before the diff, or `nil`. + + @see `-[IGListDiffable diffIdentifier]`. + */ +- (nullable NSIndexPath *)oldIndexPathForIdentifier:(id)identifier; + +/** + Returns the index path of the object with the specified identifier *after* the diff. + + @param identifier The diff identifier of the object. + + @return The index path of the object after the diff, or `nil`. + + @see `-[IGListDiffable diffIdentifier]`. + */ +- (nullable NSIndexPath *)newIndexPathForIdentifier:(id)identifier; + +/** + Creates a new result object with operations safe for use in `UITableView` and `UICollectionView` batch updates. + */ +- (IGListIndexPathResult *)resultForBatchUpdates; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexPathResult.m b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexPathResult.m new file mode 100644 index 0000000..46450d1 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexPathResult.m @@ -0,0 +1,91 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListIndexPathResult.h" +#import "IGListIndexPathResultInternal.h" + +@implementation IGListIndexPathResult { + NSMapTable, NSIndexPath *> *_oldIndexPathMap; + NSMapTable, NSIndexPath *> *_newIndexPathMap; +} + +- (instancetype)initWithInserts:(NSArray *)inserts + deletes:(NSArray *)deletes + updates:(NSArray *)updates + moves:(NSArray *)moves + oldIndexPathMap:(NSMapTable, NSIndexPath *> *)oldIndexPathMap + newIndexPathMap:(NSMapTable, NSIndexPath *> *)newIndexPathMap { + if (self = [super init]) { + _inserts = inserts; + _deletes = deletes; + _updates = updates; + _moves = moves; + _oldIndexPathMap = oldIndexPathMap; + _newIndexPathMap = newIndexPathMap; + } + return self; +} + +- (BOOL)hasChanges { + return self.changeCount > 0; +} + +- (NSInteger)changeCount { + return self.inserts.count + self.deletes.count + self.updates.count + self.moves.count; +} + +- (IGListIndexPathResult *)resultForBatchUpdates { + NSMutableSet *deletes = [NSMutableSet setWithArray:self.deletes]; + NSMutableSet *inserts = [NSMutableSet setWithArray:self.inserts]; + NSMutableSet *filteredUpdates = [NSMutableSet setWithArray:self.updates]; + + NSArray *moves = self.moves; + NSMutableArray *filteredMoves = [moves mutableCopy]; + + // convert move+update to delete+insert, respecting the from/to of the move + const NSInteger moveCount = moves.count; + for (NSInteger i = moveCount - 1; i >= 0; i--) { + IGListMoveIndexPath *move = moves[i]; + if ([filteredUpdates containsObject:move.from]) { + [filteredMoves removeObjectAtIndex:i]; + [filteredUpdates removeObject:move.from]; + [deletes addObject:move.from]; + [inserts addObject:move.to]; + } + } + + // iterate all new identifiers. if its index is updated, delete from the old index and insert the new index + for (id key in [_oldIndexPathMap keyEnumerator]) { + NSIndexPath *indexPath = [_oldIndexPathMap objectForKey:key]; + if ([filteredUpdates containsObject:indexPath]) { + [deletes addObject:indexPath]; + [inserts addObject:(id)[_newIndexPathMap objectForKey:key]]; + } + } + + return [[IGListIndexPathResult alloc] initWithInserts:[inserts allObjects] + deletes:[deletes allObjects] + updates:[NSArray new] + moves:filteredMoves + oldIndexPathMap:_oldIndexPathMap + newIndexPathMap:_newIndexPathMap]; +} + +- (NSIndexPath *)oldIndexPathForIdentifier:(id)identifier { + return [_oldIndexPathMap objectForKey:identifier]; +} + +- (NSIndexPath *)newIndexPathForIdentifier:(id)identifier { + return [_newIndexPathMap objectForKey:identifier]; +} + +- (NSString *)description { + return [NSString stringWithFormat:@"<%@ %p; %lu inserts; %lu deletes; %lu updates; %lu moves>", + NSStringFromClass(self.class), self, (unsigned long)self.inserts.count, (unsigned long)self.deletes.count, (unsigned long)self.updates.count, (unsigned long)self.moves.count]; +} + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexSetResult.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexSetResult.h new file mode 100644 index 0000000..6c81d5f --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexSetResult.h @@ -0,0 +1,85 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + A result object returned when diffing with indexes. + */ +NS_SWIFT_NAME(ListIndexSetResult) +@interface IGListIndexSetResult : NSObject + +/** + The indexes inserted into the new collection. + */ +@property (nonatomic, strong, readonly) NSIndexSet *inserts; + +/** + The indexes deleted from the old collection. + */ +@property (nonatomic, strong, readonly) NSIndexSet *deletes; + +/** + The indexes in the old collection that need updated. + */ +@property (nonatomic, strong, readonly) NSIndexSet *updates; + +/** + The moves from an index in the old collection to an index in the new collection. + */ +@property (nonatomic, copy, readonly) NSArray *moves; + +/** + A Read-only boolean that indicates whether the result has any changes or not. + `YES` if the result has changes, `NO` otherwise. + */ +@property (nonatomic, assign, readonly) BOOL hasChanges; + +/** + Returns the index of the object with the specified identifier *before* the diff. + + @param identifier The diff identifier of the object. + + @return The index of the object before the diff, or `NSNotFound`. + + @see `-[IGListDiffable diffIdentifier]`. + */ +- (NSInteger)oldIndexForIdentifier:(id)identifier; + +/** + Returns the index of the object with the specified identifier *after* the diff. + + @param identifier The diff identifier of the object. + + @return The index path of the object after the diff, or `NSNotFound`. + + @see `-[IGListDiffable diffIdentifier]`. + */ +- (NSInteger)newIndexForIdentifier:(id)identifier; + +/** + Creates a new result object with operations safe for use in `UITableView` and `UICollectionView` batch updates. + */ +- (IGListIndexSetResult *)resultForBatchUpdates; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexSetResult.m b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexSetResult.m new file mode 100644 index 0000000..74853e5 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListIndexSetResult.m @@ -0,0 +1,93 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListIndexSetResult.h" +#import "IGListIndexSetResultInternal.h" + +@implementation IGListIndexSetResult { + NSMapTable, NSNumber *> *_oldIndexMap; + NSMapTable, NSNumber *> *_newIndexMap; +} + +- (instancetype)initWithInserts:(NSIndexSet *)inserts + deletes:(NSIndexSet *)deletes + updates:(NSIndexSet *)updates + moves:(NSArray *)moves + oldIndexMap:(NSMapTable, NSNumber *> *)oldIndexMap + newIndexMap:(NSMapTable, NSNumber *> *)newIndexMap { + if (self = [super init]) { + _inserts = inserts; + _deletes = deletes; + _updates = updates; + _moves = moves; + _oldIndexMap = oldIndexMap; + _newIndexMap = newIndexMap; + } + return self; +} + +- (BOOL)hasChanges { + return self.changeCount > 0; +} + +- (NSInteger)changeCount { + return self.inserts.count + self.deletes.count + self.updates.count + self.moves.count; +} + +- (IGListIndexSetResult *)resultForBatchUpdates { + NSMutableIndexSet *deletes = [self.deletes mutableCopy]; + NSMutableIndexSet *inserts = [self.inserts mutableCopy]; + NSMutableIndexSet *filteredUpdates = [self.updates mutableCopy]; + + NSArray *moves = self.moves; + NSMutableArray *filteredMoves = [moves mutableCopy]; + + // convert all update+move to delete+insert + const NSInteger moveCount = moves.count; + for (NSInteger i = moveCount - 1; i >= 0; i--) { + IGListMoveIndex *move = moves[i]; + if ([filteredUpdates containsIndex:move.from]) { + [filteredMoves removeObjectAtIndex:i]; + [filteredUpdates removeIndex:move.from]; + [deletes addIndex:move.from]; + [inserts addIndex:move.to]; + } + } + + // iterate all new identifiers. if its index is updated, delete from the old index and insert the new index + for (id key in [_oldIndexMap keyEnumerator]) { + const NSInteger index = [[_oldIndexMap objectForKey:key] integerValue]; + if ([filteredUpdates containsIndex:index]) { + [deletes addIndex:index]; + [inserts addIndex:[[_newIndexMap objectForKey:key] integerValue]]; + } + } + + return [[IGListIndexSetResult alloc] initWithInserts:inserts + deletes:deletes + updates:[NSIndexSet new] + moves:filteredMoves + oldIndexMap:_oldIndexMap + newIndexMap:_newIndexMap]; +} + +- (NSInteger)oldIndexForIdentifier:(id)identifier { + NSNumber *index = [_oldIndexMap objectForKey:identifier]; + return index == nil ? NSNotFound : [index integerValue]; +} + +- (NSInteger)newIndexForIdentifier:(id)identifier { + NSNumber *index = [_newIndexMap objectForKey:identifier]; + return index == nil ? NSNotFound : [index integerValue]; +} + +- (NSString *)description { + return [NSString stringWithFormat:@"<%@ %p; %lu inserts; %lu deletes; %lu updates; %lu moves>", + NSStringFromClass(self.class), self, (unsigned long)self.inserts.count, (unsigned long)self.deletes.count, (unsigned long)self.updates.count, (unsigned long)self.moves.count]; +} + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMacros.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMacros.h new file mode 100644 index 0000000..5b5ef87 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMacros.h @@ -0,0 +1,28 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#ifndef IGLK_SUBCLASSING_RESTRICTED +#if defined(__has_attribute) && __has_attribute(objc_subclassing_restricted) +#define IGLK_SUBCLASSING_RESTRICTED __attribute__((objc_subclassing_restricted)) +#else +#define IGLK_SUBCLASSING_RESTRICTED +#endif // #if defined(__has_attribute) && __has_attribute(objc_subclassing_restricted) +#endif // #ifndef IGLK_SUBCLASSING_RESTRICTED + +#ifndef IGLK_UNAVAILABLE +#define IGLK_UNAVAILABLE(message) __attribute__((unavailable(message))) +#endif // #ifndef IGLK_UNAVAILABLE + +#if IGLK_LOGGING_ENABLED +#define IGLKLog( s, ... ) do { NSLog( @"IGListKit: %@", [NSString stringWithFormat: (s), ##__VA_ARGS__] ); } while(0) +#else +#define IGLKLog( s, ... ) +#endif + +#ifndef IGLK_DEBUG_DESCRIPTION_ENABLED +#define IGLK_DEBUG_DESCRIPTION_ENABLED DEBUG +#endif // #ifndef IGLK_DEBUG_DESCRIPTION_ENABLED diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndex.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndex.h new file mode 100644 index 0000000..1849bb8 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndex.h @@ -0,0 +1,40 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + An object representing a move between indexes. + */ +NS_SWIFT_NAME(ListMoveIndex) +@interface IGListMoveIndex : NSObject + +/** + An index in the old collection. + */ +@property (nonatomic, assign, readonly) NSInteger from; + +/** + An index in the new collection. + */ +@property (nonatomic, assign, readonly) NSInteger to; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndex.m b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndex.m new file mode 100644 index 0000000..dee66f4 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndex.m @@ -0,0 +1,52 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListMoveIndex.h" + +@implementation IGListMoveIndex + +- (instancetype)initWithFrom:(NSInteger)from to:(NSInteger)to { + if (self = [super init]) { + _from = from; + _to = to; + } + return self; +} + +- (NSUInteger)hash { + return _from ^ _to; +} + +- (BOOL)isEqual:(id)object { + if (object == self) { + return YES; + } + if ([object isKindOfClass:[IGListMoveIndex class]]) { + const NSInteger f1 = self.from, f2 = [object from]; + const NSInteger t1 = self.to, t2 = [object to]; + return f1 == f2 && t1 == t2; + } + return NO; +} + +- (NSComparisonResult)compare:(id)object { + const NSInteger right = [object from]; + const NSInteger left = [self from]; + if (left == right) { + return NSOrderedSame; + } else if (left < right) { + return NSOrderedAscending; + } else { + return NSOrderedDescending; + } +} + +- (NSString *)description { + return [NSString stringWithFormat:@"<%@ %p; from: %li; to: %li;>", NSStringFromClass(self.class), self, (long)self.from, (long)self.to]; +} + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndexPath.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndexPath.h new file mode 100644 index 0000000..30b7070 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndexPath.h @@ -0,0 +1,40 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + An object representing a move between indexes. + */ +NS_SWIFT_NAME(ListMoveIndexPath) +@interface IGListMoveIndexPath : NSObject + +/** + An index path in the old collection. + */ +@property (nonatomic, strong, readonly) NSIndexPath *from; + +/** + An index path in the new collection. + */ +@property (nonatomic, strong, readonly) NSIndexPath *to; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndexPath.m b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndexPath.m new file mode 100644 index 0000000..7517794 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/IGListMoveIndexPath.m @@ -0,0 +1,46 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListMoveIndexPath.h" + +@implementation IGListMoveIndexPath + +- (instancetype)initWithFrom:(NSIndexPath *)from to:(NSIndexPath *)to { + NSParameterAssert(from != nil); + NSParameterAssert(to != nil); + if (self = [super init]) { + _from = from; + _to = to; + } + return self; +} + +- (NSUInteger)hash { + return [_from hash] ^ [_to hash]; +} + +- (BOOL)isEqual:(id)object { + if (object == self) { + return YES; + } + if ([object isKindOfClass:[IGListMoveIndexPath class]]) { + NSIndexPath *f1 = self.from, *f2 = [object from]; + NSIndexPath *t1 = self.to, *t2 = [object to]; + return [f1 isEqual:f2] && [t1 isEqual:t2]; + } + return NO; +} + +- (NSComparisonResult)compare:(id)object { + return [[self from] compare:[object from]]; +} + +- (NSString *)description { + return [NSString stringWithFormat:@"<%@ %p; from: %@; to: %@;>", NSStringFromClass(self.class), self, self.from, self.to]; +} + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h new file mode 100644 index 0000000..8fec459 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h @@ -0,0 +1,27 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListIndexPathResult() + +- (instancetype)initWithInserts:(NSArray *)inserts + deletes:(NSArray *)deletes + updates:(NSArray *)updates + moves:(NSArray *)moves + oldIndexPathMap:(NSMapTable, NSIndexPath *> *)oldIndexPathMap + newIndexPathMap:(NSMapTable, NSIndexPath *> *)newIndexPathMap; + +@property (nonatomic, assign, readonly) NSInteger changeCount; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h new file mode 100644 index 0000000..db7f14a --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h @@ -0,0 +1,27 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListIndexSetResult() + +- (instancetype)initWithInserts:(NSIndexSet *)inserts + deletes:(NSIndexSet *)deletes + updates:(NSIndexSet *)updates + moves:(NSArray *)moves + oldIndexMap:(NSMapTable, NSNumber *> *)oldIndexMap + newIndexMap:(NSMapTable, NSNumber *> *)newIndexMap; + +@property (nonatomic, assign, readonly) NSInteger changeCount; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h new file mode 100644 index 0000000..069a545 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h @@ -0,0 +1,20 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListMoveIndex () + +- (instancetype)initWithFrom:(NSInteger)from to:(NSInteger)to NS_DESIGNATED_INITIALIZER; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h new file mode 100644 index 0000000..0370bb9 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h @@ -0,0 +1,18 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListMoveIndexPath () + +- (instancetype)initWithFrom:(NSIndexPath *)from to:(NSIndexPath *)to NS_DESIGNATED_INITIALIZER; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSNumber+IGListDiffable.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSNumber+IGListDiffable.h new file mode 100644 index 0000000..5f7396f --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSNumber+IGListDiffable.h @@ -0,0 +1,17 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +/** + This category provides default `IGListDiffable` conformance for `NSNumber`. + */ +@interface NSNumber (IGListDiffable) + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSNumber+IGListDiffable.m b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSNumber+IGListDiffable.m new file mode 100644 index 0000000..4f77466 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSNumber+IGListDiffable.m @@ -0,0 +1,20 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "NSNumber+IGListDiffable.h" + +@implementation NSNumber (IGListDiffable) + +- (id)diffIdentifier { + return self; +} + +- (BOOL)isEqualToDiffableObject:(id)object { + return [self isEqual:object]; +} + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSString+IGListDiffable.h b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSString+IGListDiffable.h new file mode 100644 index 0000000..aa5e95c --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSString+IGListDiffable.h @@ -0,0 +1,17 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +/** + This category provides default `IGListDiffable` conformance for `NSString`. + */ +@interface NSString (IGListDiffable) + +@end diff --git a/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSString+IGListDiffable.m b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSString+IGListDiffable.m new file mode 100644 index 0000000..71ac2f5 --- /dev/null +++ b/Demo/Pods/IGListDiffKit/Source/IGListDiffKit/NSString+IGListDiffable.m @@ -0,0 +1,20 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "NSString+IGListDiffable.h" + +@implementation NSString (IGListDiffable) + +- (id)diffIdentifier { + return self; +} + +- (BOOL)isEqualToDiffableObject:(id)object { + return [self isEqual:object]; +} + +@end diff --git a/Demo/Pods/IGListKit/LICENSE.md b/Demo/Pods/IGListKit/LICENSE.md new file mode 100755 index 0000000..87cbf53 --- /dev/null +++ b/Demo/Pods/IGListKit/LICENSE.md @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) Facebook, Inc. and its affiliates. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/Demo/Pods/IGListKit/README.md b/Demo/Pods/IGListKit/README.md new file mode 100644 index 0000000..22981eb --- /dev/null +++ b/Demo/Pods/IGListKit/README.md @@ -0,0 +1,110 @@ +

+ +

+ +

+ + Build Status + + + Coverage Status + + + Pods Version + + + Platforms + + + Carthage Compatible + +

+ +---------------- + +A data-driven `UICollectionView` framework for building fast and flexible lists. + +| | Main Features | +----------|----------------- +🙅 | Never call `performBatchUpdates(_:, completion:)` or `reloadData()` again +🏠 | Better architecture with reusable cells and components +🔠 | Create collections with multiple data types +🔑 | Decoupled diffing algorithm +✅ | Fully unit tested +🔍 | Customize your diffing behavior for your models +📱 | Simply `UICollectionView` at its core +🚀 | Extendable API +🐦 | Written in Objective-C with full Swift interop support + +`IGListKit` is built and maintained with ❤️ by [Instagram engineering](https://engineering.instagram.com/). +We use the open source version `master` branch in the Instagram app. + +## Requirements + +- Xcode 9.0+ +- iOS 9.0+ +- tvOS 9.0+ +- macOS 10.11+ *(diffing algorithm components only)* +- Interoperability with Swift 3.0+ + +## Installation + +### CocoaPods + +The preferred installation method is with [CocoaPods](https://cocoapods.org). Add the following to your `Podfile`: + +```ruby +pod 'IGListKit', '~> 4.0.0' +``` + +### Carthage + +For [Carthage](https://github.com/Carthage/Carthage), add the following to your `Cartfile`: + +```ogdl +github "Instagram/IGListKit" ~> 4.0.0 +``` + +> For advanced usage, see our [Installation Guide](https://instagram.github.io/IGListKit/installation.html). + +## Getting Started + +```bash +$ git clone https://github.com/Instagram/IGListKit.git +$ cd IGListKit/ +$ ./scripts/setup.sh +``` + +- Our [Getting Started guide](https://instagram.github.io/IGListKit/getting-started.html) +- Ray Wenderlich's [IGListKit Tutorial: Better UICollectionViews](https://www.raywenderlich.com/147162/iglistkit-tutorial-better-uicollectionviews) +- Our [example projects](https://github.com/Instagram/IGListKit/tree/master/Examples) +- Ryan Nystrom's [talk at try! Swift NYC](https://realm.io/news/tryswift-ryan-nystrom-refactoring-at-scale-lessons-learned-rewriting-instagram-feed/) (Note: this talk was for an earlier version. Some APIs have changed.) +- [Migrating an UITableView to IGListCollectionView](https://medium.com/cocoaacademymag/iglistkit-migrating-an-uitableview-to-iglistkitcollectionview-65a30cf9bac9), by Rodrigo Cavalcante +- [Keeping data fresh in Buffer for iOS with AsyncDisplayKit, IGListKit & Pusher](https://overflow.buffer.com/2017/04/10/keeping-data-fresh-buffer-ios-asyncdisplaykit-iglistkit-pusher/), Andy Yates, Buffer + +## Documentation + +You can find [the docs here](https://instagram.github.io/IGListKit). Documentation is generated with [jazzy](https://github.com/realm/jazzy) and hosted on [GitHub-Pages](https://pages.github.com). + +To regenerate docs, run `./scripts/build_docs.sh` from the root directory in the repo. + +## Vision + +For the long-term goals and "vision" of `IGListKit`, please read our [Vision](https://github.com/Instagram/IGListKit/blob/master/Guides/VISION.md) doc. + +## Contributing + +Please see the [CONTRIBUTING](https://github.com/Instagram/IGListKit/blob/master/.github/CONTRIBUTING.md) file for how to help. At Instagram, we sync the open source version of `IGListKit` daily, so we're always testing the latest changes. But that requires all changes be thoroughly tested and follow our style guide. + +We have a set of [starter tasks](https://github.com/Instagram/IGListKit/issues?q=is%3Aissue+is%3Aopen+label%3Astarter-task) that are great for beginners to jump in on and start contributing. + +## License + +`IGListKit` is [MIT-licensed](./LICENSE). + +The files in the `/Examples/` directory are licensed under a separate license as specified in each file. Documentation is licensed [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/). diff --git a/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h new file mode 100644 index 0000000..8fec459 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h @@ -0,0 +1,27 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListIndexPathResult() + +- (instancetype)initWithInserts:(NSArray *)inserts + deletes:(NSArray *)deletes + updates:(NSArray *)updates + moves:(NSArray *)moves + oldIndexPathMap:(NSMapTable, NSIndexPath *> *)oldIndexPathMap + newIndexPathMap:(NSMapTable, NSIndexPath *> *)newIndexPathMap; + +@property (nonatomic, assign, readonly) NSInteger changeCount; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h new file mode 100644 index 0000000..db7f14a --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h @@ -0,0 +1,27 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListIndexSetResult() + +- (instancetype)initWithInserts:(NSIndexSet *)inserts + deletes:(NSIndexSet *)deletes + updates:(NSIndexSet *)updates + moves:(NSArray *)moves + oldIndexMap:(NSMapTable, NSNumber *> *)oldIndexMap + newIndexMap:(NSMapTable, NSNumber *> *)newIndexMap; + +@property (nonatomic, assign, readonly) NSInteger changeCount; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h new file mode 100644 index 0000000..069a545 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h @@ -0,0 +1,20 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListMoveIndex () + +- (instancetype)initWithFrom:(NSInteger)from to:(NSInteger)to NS_DESIGNATED_INITIALIZER; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h new file mode 100644 index 0000000..0370bb9 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h @@ -0,0 +1,18 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface IGListMoveIndexPath () + +- (instancetype)initWithFrom:(NSIndexPath *)from to:(NSIndexPath *)to NS_DESIGNATED_INITIALIZER; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapter.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapter.h new file mode 100644 index 0000000..3960e67 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapter.h @@ -0,0 +1,307 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import +#import +#import +#import +#import +#import +#import + +@protocol IGListUpdatingDelegate; + +@class IGListSectionController; + +NS_ASSUME_NONNULL_BEGIN + +/** + A block to execute when the list updates are completed. + + @param finished Specifies whether or not the update animations completed successfully. + */ +NS_SWIFT_NAME(ListUpdaterCompletion) +typedef void (^IGListUpdaterCompletion)(BOOL finished); + +/** + `IGListAdapter` objects provide an abstraction for feeds of objects in a `UICollectionView` by breaking each object + into individual sections, called "section controllers". These controllers (objects subclassing to + `IGListSectionController`) act as a data source and delegate for each section. + + Feed implementations must act as the data source for an `IGListAdapter` in order to drive the objects and section + controllers in a collection view. + */ +IGLK_SUBCLASSING_RESTRICTED +NS_SWIFT_NAME(ListAdapter) +@interface IGListAdapter : NSObject + +/** + The view controller that houses the adapter. + */ +@property (nonatomic, nullable, weak) UIViewController *viewController; + +/** + The collection view used with the adapter. + + @note Setting this property will automatically set isPrefetchingEnabled to `NO` for performance reasons. + */ +@property (nonatomic, nullable, weak) UICollectionView *collectionView; + +/** + The object that acts as the data source for the adapter. + */ +@property (nonatomic, nullable, weak) id dataSource; + +/** + The object that receives top-level events for section controllers. + */ +@property (nonatomic, nullable, weak) id delegate; + +/** + The object that receives `UICollectionViewDelegate` events. + + @note This object *will not* receive `UIScrollViewDelegate` events. Instead use scrollViewDelegate. + */ +@property (nonatomic, nullable, weak) id collectionViewDelegate; + +/** + The object that receives `UIScrollViewDelegate` events. + */ +@property (nonatomic, nullable, weak) id scrollViewDelegate; + +/** + The object that receives `IGListAdapterMoveDelegate` events resulting from interactive reordering of sections. + + @note This works with UICollectionView interactive reordering available on iOS 9.0+ + */ +@property (nonatomic, nullable, weak) id moveDelegate NS_AVAILABLE_IOS(9_0); + +/** + The object that receives `IGListAdapterPerformanceDelegate` events to measure performance. + */ +@property (nonatomic, nullable, weak) id performanceDelegate; + +/** + The updater for the adapter. + */ +@property (nonatomic, strong, readonly) id updater; + +/** + A bitmask of experiments to conduct on the adapter. + */ +@property (nonatomic, assign) IGListExperiment experiments; + +/** + Initializes a new `IGListAdapter` object. + + @param updater An object that manages updates to the collection view. + @param viewController The view controller that will house the adapter. + @param workingRangeSize The number of objects before and after the viewport to consider within the working range. + + @return A new list adapter object. + + @note The working range is the number of objects beyond the visible objects (plus and minus) that should be + notified when they are close to being visible. For instance, if you have 3 objects on screen and a working range of 2, + the previous and succeeding 2 objects will be notified that they are within the working range. As you scroll the list + the range is updated as objects enter and exit the working range. + + To opt out of using the working range, use `initWithUpdater:viewController:` or provide a working range of `0`. + */ +- (instancetype)initWithUpdater:(id )updater + viewController:(nullable UIViewController *)viewController + workingRangeSize:(NSInteger)workingRangeSize NS_DESIGNATED_INITIALIZER; + +/** + Initializes a new `IGListAdapter` object with a working range of `0`. + + @param updater An object that manages updates to the collection view. + @param viewController The view controller that will house the adapter. + + @return A new list adapter object. + */ +- (instancetype)initWithUpdater:(id )updater + viewController:(nullable UIViewController *)viewController; + +/** + Perform an update from the previous state of the data source. This is analogous to calling + `-[UICollectionView performBatchUpdates:completion:]`. + + @param animated A flag indicating if the transition should be animated. + @param completion The block to execute when the updates complete. + */ +- (void)performUpdatesAnimated:(BOOL)animated completion:(nullable IGListUpdaterCompletion)completion; + +/** + Perform an immediate reload of the data in the data source, discarding the old objects. + + @param completion The block to execute when the reload completes. + + @warning Do not use this method to update without animations as it can be very expensive to teardown and rebuild all + section controllers. Use `-[IGListAdapter performUpdatesAnimated:completion]` instead. + */ +- (void)reloadDataWithCompletion:(nullable IGListUpdaterCompletion)completion; + +/** + Reload the list for only the specified objects. + + @param objects The objects to reload. + */ +- (void)reloadObjects:(NSArray *)objects; + +/** + Query the section controller at a given section index. Constant time lookup. + + @param section A section in the list. + + @return A section controller or `nil` if the section does not exist. + */ +- (nullable IGListSectionController *)sectionControllerForSection:(NSInteger)section; + +/** + Query the section index of a list. Constant time lookup. + + @param sectionController A list object. + + @return The section index of the list if it exists, otherwise `NSNotFound`. + */ +- (NSInteger)sectionForSectionController:(IGListSectionController *)sectionController; + +/** + Returns the section controller for the specified object. Constant time lookup. + + @param object An object from the data source. + + @return A section controller or `nil` if `object` is not in the list. + + @see `-[IGListAdapterDataSource listAdapter:sectionControllerForObject:]` + */ +- (__kindof IGListSectionController * _Nullable)sectionControllerForObject:(id)object; + +/** + Returns the object corresponding to the specified section controller in the list. Constant time lookup. + + @param sectionController A section controller in the list. + + @return The object for the specified section controller, or `nil` if not found. + */ +- (nullable id)objectForSectionController:(IGListSectionController *)sectionController; + +/** + Returns the object corresponding to a section in the list. Constant time lookup. + + @param section A section in the list. + + @return The object for the specified section, or `nil` if the section does not exist. + */ +- (nullable id)objectAtSection:(NSInteger)section; + +/** + Returns the section corresponding to the specified object in the list. Constant time lookup. + + @param object An object in the list. + + @return The section index of `object` if found, otherwise `NSNotFound`. + */ +- (NSInteger)sectionForObject:(id)object; + +/** + Returns a copy of all the objects currently driving the adapter. + + @return An array of objects. + */ +- (NSArray *)objects; + +/** + An unordered array of the currently visible section controllers. + + @return An array of section controllers. + */ +- (NSArray *)visibleSectionControllers; + +/** + An unordered array of the currently visible objects. + + @return An array of objects + */ +- (NSArray *)visibleObjects; + +/** + An unordered array of the currently visible cells for a given object. + + @param object An object in the list + + @return An array of collection view cells. + */ +- (NSArray *)visibleCellsForObject:(id)object; + +/** + Scrolls to the specified object in the list adapter. + + @param object The object to which to scroll. + @param supplementaryKinds The types of supplementary views in the section. + @param scrollDirection An option indicating the direction to scroll. + @param scrollPosition An option that specifies where the item should be positioned when scrolling finishes. + @param animated A flag indicating if the scrolling should be animated. + */ +- (void)scrollToObject:(id)object + supplementaryKinds:(nullable NSArray *)supplementaryKinds + scrollDirection:(UICollectionViewScrollDirection)scrollDirection + scrollPosition:(UICollectionViewScrollPosition)scrollPosition + animated:(BOOL)animated; + +/** + Returns the size of a cell at the specified index path. + + @param indexPath The index path of the cell. + + @return The size of the cell. + */ +- (CGSize)sizeForItemAtIndexPath:(NSIndexPath *)indexPath; + +/** + Returns the size of a supplementary view in the list at the specified index path. + + @param elementKind The kind of supplementary view. + @param indexPath The index path of the supplementary view. + + @return The size of the supplementary view. + */ +- (CGSize)sizeForSupplementaryViewOfKind:(NSString *)elementKind + atIndexPath:(NSIndexPath *)indexPath; + +/** + Adds a listener to the list adapter. + + @param updateListener The object conforming to the `IGListAdapterUpdateListener` protocol. + + @note Listeners are held weakly so there is no need to call `-[IGListAdapter removeUpdateListener:]` on `dealloc`. + */ +- (void)addUpdateListener:(id)updateListener; + +/** + Removes a listener from the list adapter. + + @param updateListener The object conforming to the `IGListAdapterUpdateListener` protocol. + */ +- (void)removeUpdateListener:(id)updateListener; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapter.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapter.m new file mode 100644 index 0000000..328789f --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapter.m @@ -0,0 +1,1339 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListAdapterInternal.h" + +#import +#import +#import + +#import "IGListArrayUtilsInternal.h" +#import "IGListDebugger.h" +#import "IGListSectionControllerInternal.h" +#import "UICollectionViewLayout+InteractiveReordering.h" +#import "UIScrollView+IGListKit.h" + +@implementation IGListAdapter { + NSMapTable *_viewSectionControllerMap; + // An array of blocks to execute once batch updates are finished + NSMutableArray *_queuedCompletionBlocks; + NSHashTable> *_updateListeners; +} + +- (void)dealloc { + [self.sectionMap reset]; +} + + +#pragma mark - Init + +- (instancetype)initWithUpdater:(id )updater + viewController:(UIViewController *)viewController + workingRangeSize:(NSInteger)workingRangeSize { + IGAssertMainThread(); + IGParameterAssert(updater); + + if (self = [super init]) { + NSPointerFunctions *keyFunctions = [updater objectLookupPointerFunctions]; + NSPointerFunctions *valueFunctions = [NSPointerFunctions pointerFunctionsWithOptions:NSPointerFunctionsStrongMemory]; + NSMapTable *table = [[NSMapTable alloc] initWithKeyPointerFunctions:keyFunctions valuePointerFunctions:valueFunctions capacity:0]; + _sectionMap = [[IGListSectionMap alloc] initWithMapTable:table]; + + _displayHandler = [IGListDisplayHandler new]; + _workingRangeHandler = [[IGListWorkingRangeHandler alloc] initWithWorkingRangeSize:workingRangeSize]; + _updateListeners = [NSHashTable weakObjectsHashTable]; + + _viewSectionControllerMap = [NSMapTable mapTableWithKeyOptions:NSMapTableObjectPointerPersonality | NSMapTableStrongMemory + valueOptions:NSMapTableStrongMemory]; + + _updater = updater; + _viewController = viewController; + + [IGListDebugger trackAdapter:self]; + } + return self; +} + +- (instancetype)initWithUpdater:(id)updater + viewController:(UIViewController *)viewController { + return [self initWithUpdater:updater + viewController:viewController + workingRangeSize:0]; +} + +- (UICollectionView *)collectionView { + return _collectionView; +} + +- (void)setCollectionView:(UICollectionView *)collectionView { + IGAssertMainThread(); + + // if collection view has been used by a different list adapter, treat it as if we were using a new collection view + // this happens when embedding a UICollectionView inside a UICollectionViewCell that is reused + if (_collectionView != collectionView || _collectionView.dataSource != self) { + // if the collection view was being used with another IGListAdapter (e.g. cell reuse) + // destroy the previous association so the old adapter doesn't update the wrong collection view + static NSMapTable *globalCollectionViewAdapterMap = nil; + if (globalCollectionViewAdapterMap == nil) { + globalCollectionViewAdapterMap = [NSMapTable weakToWeakObjectsMapTable]; + } + [globalCollectionViewAdapterMap removeObjectForKey:_collectionView]; + [[globalCollectionViewAdapterMap objectForKey:collectionView] setCollectionView:nil]; + [globalCollectionViewAdapterMap setObject:self forKey:collectionView]; + + // dump old registered section controllers in the case that we are changing collection views or setting for + // the first time + _registeredCellIdentifiers = [NSMutableSet new]; + _registeredNibNames = [NSMutableSet new]; + _registeredSupplementaryViewIdentifiers = [NSMutableSet new]; + _registeredSupplementaryViewNibNames = [NSMutableSet new]; + + const BOOL settingFirstCollectionView = _collectionView == nil; + + _collectionView = collectionView; + _collectionView.dataSource = self; + + if (@available(iOS 10.0, tvOS 10, *)) { + _collectionView.prefetchingEnabled = NO; + } + + [_collectionView.collectionViewLayout ig_hijackLayoutInteractiveReorderingMethodForAdapter:self]; + [_collectionView.collectionViewLayout invalidateLayout]; + + [self _updateCollectionViewDelegate]; + + // only construct + if (!IGListExperimentEnabled(self.experiments, IGListExperimentGetCollectionViewAtUpdate) + || settingFirstCollectionView) { + [self _updateAfterPublicSettingsChange]; + } + } +} + +- (void)setDataSource:(id)dataSource { + if (_dataSource != dataSource) { + _dataSource = dataSource; + [self _updateAfterPublicSettingsChange]; + } +} + +// reset and configure the delegate proxy whenever this property is set +- (void)setCollectionViewDelegate:(id)collectionViewDelegate { + IGAssertMainThread(); + IGAssert(![collectionViewDelegate conformsToProtocol:@protocol(UICollectionViewDelegateFlowLayout)], + @"UICollectionViewDelegateFlowLayout conformance is automatically handled by IGListAdapter."); + + if (_collectionViewDelegate != collectionViewDelegate) { + _collectionViewDelegate = collectionViewDelegate; + [self _createProxyAndUpdateCollectionViewDelegate]; + } +} + +- (void)setScrollViewDelegate:(id)scrollViewDelegate { + IGAssertMainThread(); + + if (_scrollViewDelegate != scrollViewDelegate) { + _scrollViewDelegate = scrollViewDelegate; + [self _createProxyAndUpdateCollectionViewDelegate]; + } +} + +- (void)_updateAfterPublicSettingsChange { + id dataSource = _dataSource; + if (_collectionView != nil && dataSource != nil) { + NSArray *uniqueObjects = objectsWithDuplicateIdentifiersRemoved([dataSource objectsForListAdapter:self]); + [self _updateObjects:uniqueObjects dataSource:dataSource]; + } +} + +- (void)_createProxyAndUpdateCollectionViewDelegate { + // there is a known bug with accessibility and using an NSProxy as the delegate that will cause EXC_BAD_ACCESS + // when voiceover is enabled. it will hold an unsafe ref to the delegate + _collectionView.delegate = nil; + + self.delegateProxy = [[IGListAdapterProxy alloc] initWithCollectionViewTarget:_collectionViewDelegate + scrollViewTarget:_scrollViewDelegate + interceptor:self]; + [self _updateCollectionViewDelegate]; +} + +- (void)_updateCollectionViewDelegate { + // set up the delegate to the proxy so the adapter can intercept events + // default to the adapter simply being the delegate + _collectionView.delegate = (id)self.delegateProxy ?: self; +} + + +#pragma mark - Scrolling + +- (void)scrollToObject:(id)object + supplementaryKinds:(NSArray *)supplementaryKinds + scrollDirection:(UICollectionViewScrollDirection)scrollDirection + scrollPosition:(UICollectionViewScrollPosition)scrollPosition + animated:(BOOL)animated { + IGAssertMainThread(); + IGParameterAssert(object != nil); + + const NSInteger section = [self sectionForObject:object]; + if (section == NSNotFound) { + return; + } + + UICollectionView *collectionView = self.collectionView; + const BOOL avoidLayout = IGListExperimentEnabled(self.experiments, IGListExperimentAvoidLayoutOnScrollToObject); + + // Experiment with skipping the forced layout to avoid creating off-screen cells. + // Calling [collectionView layoutIfNeeded] creates the current visible cells that will no longer be visible after the scroll. + // We can avoid that by asking the UICollectionView (not the layout object) for the attributes. So if the attributes are not + // ready, the UICollectionView will call -prepareLayout, return the attributes, but doesn't generate the cells just yet. + if (!avoidLayout) { + [collectionView setNeedsLayout]; + [collectionView layoutIfNeeded]; + } + + NSIndexPath *indexPathFirstElement = [NSIndexPath indexPathForItem:0 inSection:section]; + + // collect the layout attributes for the cell and supplementary views for the first index + // this will break if there are supplementary views beyond item 0 + NSMutableArray *attributes = nil; + + const NSInteger numberOfItems = [collectionView numberOfItemsInSection:section]; + if (numberOfItems > 0) { + attributes = [self _layoutAttributesForItemAndSupplementaryViewAtIndexPath:indexPathFirstElement + supplementaryKinds:supplementaryKinds].mutableCopy; + + if (numberOfItems > 1) { + NSIndexPath *indexPathLastElement = [NSIndexPath indexPathForItem:(numberOfItems - 1) inSection:section]; + UICollectionViewLayoutAttributes *lastElementattributes = [self _layoutAttributesForItemAndSupplementaryViewAtIndexPath:indexPathLastElement + supplementaryKinds:supplementaryKinds].firstObject; + if (lastElementattributes != nil) { + [attributes addObject:lastElementattributes]; + } + } + } else { + NSMutableArray *supplementaryAttributes = [NSMutableArray new]; + for (NSString* supplementaryKind in supplementaryKinds) { + UICollectionViewLayoutAttributes *supplementaryAttribute = [self _layoutAttributesForSupplementaryViewOfKind:supplementaryKind atIndexPath:indexPathFirstElement]; + if (supplementaryAttribute != nil) { + [supplementaryAttributes addObject: supplementaryAttribute]; + } + } + attributes = supplementaryAttributes; + } + + CGFloat offsetMin = 0.0; + CGFloat offsetMax = 0.0; + for (UICollectionViewLayoutAttributes *attribute in attributes) { + const CGRect frame = attribute.frame; + CGFloat originMin; + CGFloat endMax; + switch (scrollDirection) { + case UICollectionViewScrollDirectionHorizontal: + originMin = CGRectGetMinX(frame); + endMax = CGRectGetMaxX(frame); + break; + case UICollectionViewScrollDirectionVertical: + originMin = CGRectGetMinY(frame); + endMax = CGRectGetMaxY(frame); + break; + } + + // find the minimum origin value of all the layout attributes + if (attribute == attributes.firstObject || originMin < offsetMin) { + offsetMin = originMin; + } + // find the maximum end value of all the layout attributes + if (attribute == attributes.firstObject || endMax > offsetMax) { + offsetMax = endMax; + } + } + + const CGFloat offsetMid = (offsetMin + offsetMax) / 2.0; + const CGFloat collectionViewWidth = collectionView.bounds.size.width; + const CGFloat collectionViewHeight = collectionView.bounds.size.height; + const UIEdgeInsets contentInset = collectionView.ig_contentInset; + CGPoint contentOffset = collectionView.contentOffset; + switch (scrollDirection) { + case UICollectionViewScrollDirectionHorizontal: { + switch (scrollPosition) { + case UICollectionViewScrollPositionRight: + contentOffset.x = offsetMax - collectionViewWidth + contentInset.right; + break; + case UICollectionViewScrollPositionCenteredHorizontally: { + const CGFloat insets = (contentInset.left - contentInset.right) / 2.0; + contentOffset.x = offsetMid - collectionViewWidth / 2.0 - insets; + break; + } + case UICollectionViewScrollPositionLeft: + case UICollectionViewScrollPositionNone: + case UICollectionViewScrollPositionTop: + case UICollectionViewScrollPositionBottom: + case UICollectionViewScrollPositionCenteredVertically: + contentOffset.x = offsetMin - contentInset.left; + break; + } + const CGFloat maxOffsetX = collectionView.contentSize.width - collectionView.frame.size.width + contentInset.right; + const CGFloat minOffsetX = -contentInset.left; + contentOffset.x = MIN(contentOffset.x, maxOffsetX); + contentOffset.x = MAX(contentOffset.x, minOffsetX); + break; + } + case UICollectionViewScrollDirectionVertical: { + switch (scrollPosition) { + case UICollectionViewScrollPositionBottom: + contentOffset.y = offsetMax - collectionViewHeight + contentInset.bottom; + break; + case UICollectionViewScrollPositionCenteredVertically: { + const CGFloat insets = (contentInset.top - contentInset.bottom) / 2.0; + contentOffset.y = offsetMid - collectionViewHeight / 2.0 - insets; + break; + } + case UICollectionViewScrollPositionTop: + case UICollectionViewScrollPositionNone: + case UICollectionViewScrollPositionLeft: + case UICollectionViewScrollPositionRight: + case UICollectionViewScrollPositionCenteredHorizontally: + contentOffset.y = offsetMin - contentInset.top; + break; + } + CGFloat maxHeight; + if (avoidLayout) { + // If we don't call [collectionView layoutIfNeeded], the collectionView.contentSize does not get updated. + // So lets use the layout object, since it should have been updated by now. + maxHeight = collectionView.collectionViewLayout.collectionViewContentSize.height; + } else { + maxHeight = collectionView.contentSize.height; + } + const CGFloat maxOffsetY = maxHeight - collectionView.frame.size.height + contentInset.bottom; + const CGFloat minOffsetY = -contentInset.top; + contentOffset.y = MIN(contentOffset.y, maxOffsetY); + contentOffset.y = MAX(contentOffset.y, minOffsetY); + break; + } + } + + [collectionView setContentOffset:contentOffset animated:animated]; +} + +#pragma mark - Editing + +- (void)performUpdatesAnimated:(BOOL)animated completion:(IGListUpdaterCompletion)completion { + IGAssertMainThread(); + + id dataSource = self.dataSource; + UICollectionView *collectionView = self.collectionView; + if (dataSource == nil || collectionView == nil) { + IGLKLog(@"Warning: Your call to %s is ignored as dataSource or collectionView haven't been set.", __PRETTY_FUNCTION__); + if (completion) { + completion(NO); + } + return; + } + + NSArray *fromObjects = self.sectionMap.objects; + + IGListToObjectBlock toObjectsBlock; + __weak __typeof__(self) weakSelf = self; + if (IGListExperimentEnabled(self.experiments, IGListExperimentDeferredToObjectCreation)) { + toObjectsBlock = ^NSArray *{ + __typeof__(self) strongSelf = weakSelf; + if (strongSelf == nil) { + return nil; + } + return [dataSource objectsForListAdapter:strongSelf]; + }; + } else { + NSArray *newObjects = [dataSource objectsForListAdapter:self]; + toObjectsBlock = ^NSArray *{ + return newObjects; + }; + } + + [self _enterBatchUpdates]; + [self.updater performUpdateWithCollectionViewBlock:[self _collectionViewBlock] + fromObjects:fromObjects + toObjectsBlock:toObjectsBlock + animated:animated + objectTransitionBlock:^(NSArray *toObjects) { + // temporarily capture the item map that we are transitioning from in case + // there are any item deletes at the same + weakSelf.previousSectionMap = [weakSelf.sectionMap copy]; + + [weakSelf _updateObjects:toObjects dataSource:dataSource]; + } completion:^(BOOL finished) { + // release the previous items + weakSelf.previousSectionMap = nil; + + [weakSelf _notifyDidUpdate:IGListAdapterUpdateTypePerformUpdates animated:animated]; + if (completion) { + completion(finished); + } + [weakSelf _exitBatchUpdates]; + }]; +} + +- (void)reloadDataWithCompletion:(nullable IGListUpdaterCompletion)completion { + IGAssertMainThread(); + + id dataSource = self.dataSource; + UICollectionView *collectionView = self.collectionView; + if (dataSource == nil || collectionView == nil) { + IGLKLog(@"Warning: Your call to %s is ignored as dataSource or collectionView haven't been set.", __PRETTY_FUNCTION__); + if (completion) { + completion(NO); + } + return; + } + + NSArray *uniqueObjects = objectsWithDuplicateIdentifiersRemoved([dataSource objectsForListAdapter:self]); + + __weak __typeof__(self) weakSelf = self; + [self.updater reloadDataWithCollectionViewBlock:[self _collectionViewBlock] + reloadUpdateBlock:^{ + // purge all section controllers from the item map so that they are regenerated + [weakSelf.sectionMap reset]; + [weakSelf _updateObjects:uniqueObjects dataSource:dataSource]; + } completion:^(BOOL finished) { + [weakSelf _notifyDidUpdate:IGListAdapterUpdateTypeReloadData animated:NO]; + if (completion) { + completion(finished); + } + }]; +} + +- (void)reloadObjects:(NSArray *)objects { + IGAssertMainThread(); + IGParameterAssert(objects); + + NSMutableIndexSet *sections = [NSMutableIndexSet new]; + + // use the item map based on whether or not we're in an update block + IGListSectionMap *map = [self _sectionMapUsingPreviousIfInUpdateBlock:YES]; + + for (id object in objects) { + // look up the item using the map's lookup function. might not be the same item + const NSInteger section = [map sectionForObject:object]; + const BOOL notFound = section == NSNotFound; + if (notFound) { + continue; + } + [sections addIndex:section]; + + // reverse lookup the item using the section. if the pointer has changed the trigger update events and swap items + if (object != [map objectForSection:section]) { + [map updateObject:object]; + [[map sectionControllerForSection:section] didUpdateToObject:object]; + } + } + + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Tried to reload the adapter without a collection view"); + + [self.updater reloadCollectionView:collectionView sections:sections]; +} + +- (void)addUpdateListener:(id)updateListener { + IGAssertMainThread(); + IGParameterAssert(updateListener != nil); + + [_updateListeners addObject:updateListener]; +} + +- (void)removeUpdateListener:(id)updateListener { + IGAssertMainThread(); + IGParameterAssert(updateListener != nil); + + [_updateListeners removeObject:updateListener]; +} + +- (void)_notifyDidUpdate:(IGListAdapterUpdateType)update animated:(BOOL)animated { + for (id listener in _updateListeners) { + [listener listAdapter:self didFinishUpdate:update animated:animated]; + } +} + + +#pragma mark - List Items & Sections + +- (nullable IGListSectionController *)sectionControllerForSection:(NSInteger)section { + IGAssertMainThread(); + + return [self.sectionMap sectionControllerForSection:section]; +} + +- (NSInteger)sectionForSectionController:(IGListSectionController *)sectionController { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + + return [self.sectionMap sectionForSectionController:sectionController]; +} + +- (IGListSectionController *)sectionControllerForObject:(id)object { + IGAssertMainThread(); + IGParameterAssert(object != nil); + + return [self.sectionMap sectionControllerForObject:object]; +} + +- (id)objectForSectionController:(IGListSectionController *)sectionController { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + + const NSInteger section = [self.sectionMap sectionForSectionController:sectionController]; + return [self.sectionMap objectForSection:section]; +} + +- (id)objectAtSection:(NSInteger)section { + IGAssertMainThread(); + + return [self.sectionMap objectForSection:section]; +} + +- (NSInteger)sectionForObject:(id)item { + IGAssertMainThread(); + IGParameterAssert(item != nil); + + return [self.sectionMap sectionForObject:item]; +} + +- (NSArray *)objects { + IGAssertMainThread(); + + return self.sectionMap.objects; +} + +- (id)_supplementaryViewSourceAtIndexPath:(NSIndexPath *)indexPath { + IGListSectionController *sectionController = [self sectionControllerForSection:indexPath.section]; + return [sectionController supplementaryViewSource]; +} + +- (NSArray *)visibleSectionControllers { + IGAssertMainThread(); + return [[self.displayHandler visibleListSections] allObjects]; +} + +- (NSArray *)visibleObjects { + IGAssertMainThread(); + NSArray *visibleCells = [self.collectionView visibleCells]; + NSMutableSet *visibleObjects = [NSMutableSet new]; + for (UICollectionViewCell *cell in visibleCells) { + IGListSectionController *sectionController = [self sectionControllerForView:cell]; + IGAssert(sectionController != nil, @"Section controller nil for cell %@", cell); + if (sectionController != nil) { + const NSInteger section = [self sectionForSectionController:sectionController]; + id object = [self objectAtSection:section]; + IGAssert(object != nil, @"Object not found for section controller %@ at section %li", sectionController, (long)section); + if (object != nil) { + [visibleObjects addObject:object]; + } + } + } + return [visibleObjects allObjects]; +} + +- (NSArray *)visibleCellsForObject:(id)object { + IGAssertMainThread(); + IGParameterAssert(object != nil); + + const NSInteger section = [self.sectionMap sectionForObject:object]; + if (section == NSNotFound) { + return [NSArray new]; + } + + NSArray *visibleCells = [self.collectionView visibleCells]; + UICollectionView *collectionView = self.collectionView; + NSPredicate *controllerPredicate = [NSPredicate predicateWithBlock:^BOOL(UICollectionViewCell* cell, NSDictionary* bindings) { + NSIndexPath *indexPath = [collectionView indexPathForCell:cell]; + return indexPath.section == section; + }]; + + return [visibleCells filteredArrayUsingPredicate:controllerPredicate]; +} + + +#pragma mark - Layout + +- (CGSize)sizeForItemAtIndexPath:(NSIndexPath *)indexPath { + IGAssertMainThread(); + id performanceDelegate = self.performanceDelegate; + [performanceDelegate listAdapterWillCallSize:self]; + + IGListSectionController *sectionController = [self sectionControllerForSection:indexPath.section]; + const CGSize size = [sectionController sizeForItemAtIndex:indexPath.item]; + const CGSize positiveSize = CGSizeMake(MAX(size.width, 0.0), MAX(size.height, 0.0)); + + [performanceDelegate listAdapter:self didCallSizeOnSectionController:sectionController atIndex:indexPath.item]; + return positiveSize; +} + +- (CGSize)sizeForSupplementaryViewOfKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath { + IGAssertMainThread(); + id supplementaryViewSource = [self _supplementaryViewSourceAtIndexPath:indexPath]; + if ([[supplementaryViewSource supportedElementKinds] containsObject:elementKind]) { + const CGSize size = [supplementaryViewSource sizeForSupplementaryViewOfKind:elementKind atIndex:indexPath.item]; + return CGSizeMake(MAX(size.width, 0.0), MAX(size.height, 0.0)); + } + return CGSizeZero; +} + + +#pragma mark - Private API + +- (IGListCollectionViewBlock)_collectionViewBlock { + if (IGListExperimentEnabled(self.experiments, IGListExperimentGetCollectionViewAtUpdate)) { + __weak __typeof__(self) weakSelf = self; + return ^UICollectionView *{ return weakSelf.collectionView; }; + } else { + __weak UICollectionView *collectionView = _collectionView; + return ^UICollectionView *{ return collectionView; }; + } +} + +// this method is what updates the "source of truth" +// this should only be called just before the collection view is updated +- (void)_updateObjects:(NSArray *)objects dataSource:(id)dataSource { + IGParameterAssert(dataSource != nil); + +#if DEBUG + for (id object in objects) { + IGAssert([object isEqualToDiffableObject:object], @"Object instance %@ not equal to itself. This will break infra map tables.", object); + } +#endif + + NSMutableArray *sectionControllers = [NSMutableArray new]; + NSMutableArray *validObjects = [NSMutableArray new]; + + IGListSectionMap *map = self.sectionMap; + + // collect items that have changed since the last update + NSMutableSet *updatedObjects = [NSMutableSet new]; + + // push the view controller and collection context into a local thread container so they are available on init + // for IGListSectionController subclasses after calling [super init] + IGListSectionControllerPushThread(self.viewController, self); + + for (id object in objects) { + // infra checks to see if a controller exists + IGListSectionController *sectionController = [map sectionControllerForObject:object]; + + // if not, query the data source for a new one + if (sectionController == nil) { + sectionController = [dataSource listAdapter:self sectionControllerForObject:object]; + } + + if (sectionController == nil) { + IGLKLog(@"WARNING: Ignoring nil section controller returned by data source %@ for object %@.", + dataSource, object); + continue; + } + + // in case the section controller was created outside of -listAdapter:sectionControllerForObject: + sectionController.collectionContext = self; + sectionController.viewController = self.viewController; + + // check if the item has changed instances or is new + const NSInteger oldSection = [map sectionForObject:object]; + if (oldSection == NSNotFound || [map objectForSection:oldSection] != object) { + [updatedObjects addObject:object]; + } + + [sectionControllers addObject:sectionController]; + [validObjects addObject:object]; + } + +#if DEBUG + IGAssert([NSSet setWithArray:sectionControllers].count == sectionControllers.count, + @"Section controllers array is not filled with unique objects; section controllers are being reused"); +#endif + + // clear the view controller and collection context + IGListSectionControllerPopThread(); + + [map updateWithObjects:validObjects sectionControllers:sectionControllers]; + + // now that the maps have been created and contexts are assigned, we consider the section controller "fully loaded" + for (id object in updatedObjects) { + [[map sectionControllerForObject:object] didUpdateToObject:object]; + } + + NSInteger itemCount = 0; + for (IGListSectionController *sectionController in sectionControllers) { + itemCount += [sectionController numberOfItems]; + } + + [self _updateBackgroundViewShouldHide:itemCount > 0]; +} + +- (void)_updateBackgroundViewShouldHide:(BOOL)shouldHide { + if (self.isInUpdateBlock) { + return; // will be called again when update block completes + } + UIView *backgroundView = [self.dataSource emptyViewForListAdapter:self]; + // don't do anything if the client is using the same view + if (backgroundView != _collectionView.backgroundView) { + // collection view will just stack the background views underneath each other if we do not remove the previous + // one first. also fine if it is nil + [_collectionView.backgroundView removeFromSuperview]; + _collectionView.backgroundView = backgroundView; + } + _collectionView.backgroundView.hidden = shouldHide; +} + +- (BOOL)_itemCountIsZero { + __block BOOL isZero = YES; + [self.sectionMap enumerateUsingBlock:^(id _Nonnull object, IGListSectionController * _Nonnull sectionController, NSInteger section, BOOL * _Nonnull stop) { + if (sectionController.numberOfItems > 0) { + isZero = NO; + *stop = YES; + } + }]; + return isZero; +} + +- (IGListSectionMap *)_sectionMapUsingPreviousIfInUpdateBlock:(BOOL)usePreviousMapIfInUpdateBlock { + // if we are inside an update block, we may have to use the /previous/ item map for some operations + IGListSectionMap *previousSectionMap = self.previousSectionMap; + if (usePreviousMapIfInUpdateBlock && self.isInUpdateBlock && previousSectionMap != nil) { + return previousSectionMap; + } else { + return self.sectionMap; + } +} + +- (NSArray *)indexPathsFromSectionController:(IGListSectionController *)sectionController + indexes:(NSIndexSet *)indexes + usePreviousIfInUpdateBlock:(BOOL)usePreviousIfInUpdateBlock { + NSMutableArray *indexPaths = [NSMutableArray new]; + + IGListSectionMap *map = [self _sectionMapUsingPreviousIfInUpdateBlock:usePreviousIfInUpdateBlock]; + const NSInteger section = [map sectionForSectionController:sectionController]; + if (section != NSNotFound) { + [indexes enumerateIndexesUsingBlock:^(NSUInteger idx, BOOL *stop) { + [indexPaths addObject:[NSIndexPath indexPathForItem:idx inSection:section]]; + }]; + } + return indexPaths; +} + +- (NSIndexPath *)indexPathForSectionController:(IGListSectionController *)controller + index:(NSInteger)index + usePreviousIfInUpdateBlock:(BOOL)usePreviousIfInUpdateBlock { + IGListSectionMap *map = [self _sectionMapUsingPreviousIfInUpdateBlock:usePreviousIfInUpdateBlock]; + const NSInteger section = [map sectionForSectionController:controller]; + if (section == NSNotFound) { + return nil; + } else { + return [NSIndexPath indexPathForItem:index inSection:section]; + } +} + +- (NSArray *)_layoutAttributesForItemAndSupplementaryViewAtIndexPath:(NSIndexPath *)indexPath + supplementaryKinds:(NSArray *)supplementaryKinds { + NSMutableArray *attributes = [NSMutableArray new]; + + UICollectionViewLayoutAttributes *cellAttributes = [self _layoutAttributesForItemAtIndexPath:indexPath]; + if (cellAttributes) { + [attributes addObject:cellAttributes]; + } + + for (NSString *kind in supplementaryKinds) { + UICollectionViewLayoutAttributes *supplementaryAttributes = [self _layoutAttributesForSupplementaryViewOfKind:kind atIndexPath:indexPath]; + if (supplementaryAttributes) { + [attributes addObject:supplementaryAttributes]; + } + } + + return attributes; +} + +- (nullable UICollectionViewLayoutAttributes *)_layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath { + if (IGListExperimentEnabled(self.experiments, IGListExperimentAvoidLayoutOnScrollToObject)) { + return [self.collectionView layoutAttributesForItemAtIndexPath:indexPath]; + } else { + return [self.collectionView.collectionViewLayout layoutAttributesForItemAtIndexPath:indexPath]; + } +} + +- (nullable UICollectionViewLayoutAttributes *)_layoutAttributesForSupplementaryViewOfKind:(NSString *)elementKind + atIndexPath:(NSIndexPath *)indexPath { + if (IGListExperimentEnabled(self.experiments, IGListExperimentAvoidLayoutOnScrollToObject)) { + return [self.collectionView layoutAttributesForSupplementaryElementOfKind:elementKind atIndexPath:indexPath]; + } else { + return [self.collectionView.collectionViewLayout layoutAttributesForSupplementaryViewOfKind:elementKind atIndexPath:indexPath]; + } +} + +- (void)mapView:(UICollectionReusableView *)view toSectionController:(IGListSectionController *)sectionController { + IGAssertMainThread(); + IGParameterAssert(view != nil); + IGParameterAssert(sectionController != nil); + [_viewSectionControllerMap setObject:sectionController forKey:view]; +} + +- (nullable IGListSectionController *)sectionControllerForView:(UICollectionReusableView *)view { + IGAssertMainThread(); + return [_viewSectionControllerMap objectForKey:view]; +} + +- (void)removeMapForView:(UICollectionReusableView *)view { + IGAssertMainThread(); + [_viewSectionControllerMap removeObjectForKey:view]; +} + +- (void)_deferBlockBetweenBatchUpdates:(void (^)(void))block { + IGAssertMainThread(); + if (_queuedCompletionBlocks == nil) { + block(); + } else { + [_queuedCompletionBlocks addObject:block]; + } +} + +- (void)_enterBatchUpdates { + _queuedCompletionBlocks = [NSMutableArray new]; +} + +- (void)_exitBatchUpdates { + NSArray *blocks = [_queuedCompletionBlocks copy]; + _queuedCompletionBlocks = nil; + for (void (^block)(void) in blocks) { + block(); + } +} + +#pragma mark - UIScrollViewDelegate + +- (void)scrollViewDidScroll:(UIScrollView *)scrollView { + id performanceDelegate = self.performanceDelegate; + [performanceDelegate listAdapterWillCallScroll:self]; + + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id scrollViewDelegate = self.scrollViewDelegate; + if ([scrollViewDelegate respondsToSelector:@selector(scrollViewDidScroll:)]) { + [scrollViewDelegate scrollViewDidScroll:scrollView]; + } + NSArray *visibleSectionControllers = [self visibleSectionControllers]; + for (IGListSectionController *sectionController in visibleSectionControllers) { + [[sectionController scrollDelegate] listAdapter:self didScrollSectionController:sectionController]; + } + + [performanceDelegate listAdapter:self didCallScroll:scrollView]; +} + +- (void)scrollViewWillBeginDragging:(UIScrollView *)scrollView { + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id scrollViewDelegate = self.scrollViewDelegate; + if ([scrollViewDelegate respondsToSelector:@selector(scrollViewWillBeginDragging:)]) { + [scrollViewDelegate scrollViewWillBeginDragging:scrollView]; + } + NSArray *visibleSectionControllers = [self visibleSectionControllers]; + for (IGListSectionController *sectionController in visibleSectionControllers) { + [[sectionController scrollDelegate] listAdapter:self willBeginDraggingSectionController:sectionController]; + } +} + +- (void)scrollViewDidEndDragging:(UIScrollView *)scrollView willDecelerate:(BOOL)decelerate { + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id scrollViewDelegate = self.scrollViewDelegate; + if ([scrollViewDelegate respondsToSelector:@selector(scrollViewDidEndDragging:willDecelerate:)]) { + [scrollViewDelegate scrollViewDidEndDragging:scrollView willDecelerate:decelerate]; + } + NSArray *visibleSectionControllers = [self visibleSectionControllers]; + for (IGListSectionController *sectionController in visibleSectionControllers) { + [[sectionController scrollDelegate] listAdapter:self didEndDraggingSectionController:sectionController willDecelerate:decelerate]; + } +} + +- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView { + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id scrollViewDelegate = self.scrollViewDelegate; + if ([scrollViewDelegate respondsToSelector:@selector(scrollViewDidEndDecelerating:)]) { + [scrollViewDelegate scrollViewDidEndDecelerating:scrollView]; + } + NSArray *visibleSectionControllers = [self visibleSectionControllers]; + for (IGListSectionController *sectionController in visibleSectionControllers) { + id scrollDelegate = [sectionController scrollDelegate]; + if ([scrollDelegate respondsToSelector:@selector(listAdapter:didEndDeceleratingSectionController:)]) { + [scrollDelegate listAdapter:self didEndDeceleratingSectionController:sectionController]; + } + } +} + +#pragma mark - IGListCollectionContext + +- (CGSize)containerSize { + return self.collectionView.bounds.size; +} + +- (UIEdgeInsets)containerInset { + return self.collectionView.contentInset; +} + +- (UIEdgeInsets)adjustedContainerInset { + return self.collectionView.ig_contentInset; +} + +- (CGSize)insetContainerSize { + UICollectionView *collectionView = self.collectionView; + return UIEdgeInsetsInsetRect(collectionView.bounds, collectionView.ig_contentInset).size; +} + +- (IGListCollectionScrollingTraits)scrollingTraits { + UICollectionView *collectionView = self.collectionView; + return (IGListCollectionScrollingTraits) { + .isTracking = collectionView.isTracking, + .isDragging = collectionView.isDragging, + .isDecelerating = collectionView.isDecelerating, + }; +} + +- (CGSize)containerSizeForSectionController:(IGListSectionController *)sectionController { + const UIEdgeInsets inset = sectionController.inset; + return CGSizeMake(self.containerSize.width - inset.left - inset.right, + self.containerSize.height - inset.top - inset.bottom); +} + +- (NSInteger)indexForCell:(UICollectionViewCell *)cell sectionController:(nonnull IGListSectionController *)sectionController { + IGAssertMainThread(); + IGParameterAssert(cell != nil); + IGParameterAssert(sectionController != nil); + NSIndexPath *indexPath = [self.collectionView indexPathForCell:cell]; + IGAssert(indexPath == nil + || indexPath.section == [self sectionForSectionController:sectionController], + @"Requesting a cell from another section controller is not allowed."); + return indexPath != nil ? indexPath.item : NSNotFound; +} + +- (__kindof UICollectionViewCell *)cellForItemAtIndex:(NSInteger)index + sectionController:(IGListSectionController *)sectionController { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + + // if this is accessed while a cell is being dequeued or displaying working range elements, just return nil + if (_isDequeuingCell || _isSendingWorkingRangeDisplayUpdates) { + return nil; + } + + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:YES]; + // prevent querying the collection view if it isn't fully reloaded yet for the current data set + if (indexPath != nil + && indexPath.section < [self.collectionView numberOfSections]) { + // only return a cell if it belongs to the section controller + // this association is created in -collectionView:cellForItemAtIndexPath: + UICollectionViewCell *cell = [self.collectionView cellForItemAtIndexPath:indexPath]; + if ([self sectionControllerForView:cell] == sectionController) { + return cell; + } + } + return nil; +} + +- (NSArray *)visibleCellsForSectionController:(IGListSectionController *)sectionController { + NSMutableArray *cells = [NSMutableArray new]; + UICollectionView *collectionView = self.collectionView; + NSArray *visibleCells = [collectionView visibleCells]; + const NSInteger section = [self sectionForSectionController:sectionController]; + for (UICollectionViewCell *cell in visibleCells) { + if ([collectionView indexPathForCell:cell].section == section) { + [cells addObject:cell]; + } + } + return cells; +} + +- (NSArray *)visibleIndexPathsForSectionController:(IGListSectionController *) sectionController { + NSMutableArray *paths = [NSMutableArray new]; + UICollectionView *collectionView = self.collectionView; + NSArray *visiblePaths = [collectionView indexPathsForVisibleItems]; + const NSInteger section = [self sectionForSectionController:sectionController]; + for (NSIndexPath *path in visiblePaths) { + if (path.section == section) { + [paths addObject:path]; + } + } + return paths; +} + +- (void)deselectItemAtIndex:(NSInteger)index + sectionController:(IGListSectionController *)sectionController + animated:(BOOL)animated { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + [self.collectionView deselectItemAtIndexPath:indexPath animated:animated]; +} + +- (void)selectItemAtIndex:(NSInteger)index + sectionController:(IGListSectionController *)sectionController + animated:(BOOL)animated + scrollPosition:(UICollectionViewScrollPosition)scrollPosition { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + [self.collectionView selectItemAtIndexPath:indexPath animated:animated scrollPosition:scrollPosition]; +} + +- (__kindof UICollectionViewCell *)dequeueReusableCellOfClass:(Class)cellClass + withReuseIdentifier:(NSString *)reuseIdentifier + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + IGParameterAssert(cellClass != nil); + IGParameterAssert(index >= 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Dequeueing cell of class %@ with reuseIdentifier %@ from section controller %@ without a collection view at index %li", NSStringFromClass(cellClass), reuseIdentifier, sectionController, (long)index); + NSString *identifier = IGListReusableViewIdentifier(cellClass, nil, reuseIdentifier); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + if (![self.registeredCellIdentifiers containsObject:identifier]) { + [self.registeredCellIdentifiers addObject:identifier]; + [collectionView registerClass:cellClass forCellWithReuseIdentifier:identifier]; + } + return [collectionView dequeueReusableCellWithReuseIdentifier:identifier forIndexPath:indexPath]; +} + +- (__kindof UICollectionViewCell *)dequeueReusableCellOfClass:(Class)cellClass + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index { + return [self dequeueReusableCellOfClass:cellClass withReuseIdentifier:nil forSectionController:sectionController atIndex:index]; +} + +- (__kindof UICollectionViewCell *)dequeueReusableCellFromStoryboardWithIdentifier:(NSString *)identifier + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + IGParameterAssert(identifier.length > 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Reloading adapter without a collection view."); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + return [collectionView dequeueReusableCellWithReuseIdentifier:identifier forIndexPath:indexPath]; +} + +- (UICollectionViewCell *)dequeueReusableCellWithNibName:(NSString *)nibName + bundle:(NSBundle *)bundle + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index { + IGAssertMainThread(); + IGParameterAssert([nibName length] > 0); + IGParameterAssert(sectionController != nil); + IGParameterAssert(index >= 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Dequeueing cell with nib name %@ and bundle %@ from section controller %@ without a collection view at index %li.", nibName, bundle, sectionController, (long)index); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + if (![self.registeredNibNames containsObject:nibName]) { + [self.registeredNibNames addObject:nibName]; + UINib *nib = [UINib nibWithNibName:nibName bundle:bundle]; + [collectionView registerNib:nib forCellWithReuseIdentifier:nibName]; + } + return [collectionView dequeueReusableCellWithReuseIdentifier:nibName forIndexPath:indexPath]; +} + +- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewOfKind:(NSString *)elementKind + forSectionController:(IGListSectionController *)sectionController + class:(Class)viewClass + atIndex:(NSInteger)index { + IGAssertMainThread(); + IGParameterAssert(elementKind.length > 0); + IGParameterAssert(sectionController != nil); + IGParameterAssert(viewClass != nil); + IGParameterAssert(index >= 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Dequeueing cell of class %@ from section controller %@ without a collection view at index %li with supplementary view %@", NSStringFromClass(viewClass), sectionController, (long)index, elementKind); + NSString *identifier = IGListReusableViewIdentifier(viewClass, elementKind, nil); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + if (![self.registeredSupplementaryViewIdentifiers containsObject:identifier]) { + [self.registeredSupplementaryViewIdentifiers addObject:identifier]; + [collectionView registerClass:viewClass forSupplementaryViewOfKind:elementKind withReuseIdentifier:identifier]; + } + return [collectionView dequeueReusableSupplementaryViewOfKind:elementKind withReuseIdentifier:identifier forIndexPath:indexPath]; +} + +- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewFromStoryboardOfKind:(NSString *)elementKind + withIdentifier:(NSString *)identifier + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index { + IGAssertMainThread(); + IGParameterAssert(elementKind.length > 0); + IGParameterAssert(identifier.length > 0); + IGParameterAssert(sectionController != nil); + IGParameterAssert(index >= 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Dequeueing Supplementary View from storyboard of kind %@ with identifier %@ for section controller %@ without a collection view at index %li", elementKind, identifier, sectionController, (long)index); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + return [collectionView dequeueReusableSupplementaryViewOfKind:elementKind withReuseIdentifier:identifier forIndexPath:indexPath]; +} + +- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewOfKind:(NSString *)elementKind + forSectionController:(IGListSectionController *)sectionController + nibName:(NSString *)nibName + bundle:(NSBundle *)bundle + atIndex:(NSInteger)index { + IGAssertMainThread(); + IGParameterAssert([nibName length] > 0); + IGParameterAssert([elementKind length] > 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Reloading adapter without a collection view."); + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + if (![self.registeredSupplementaryViewNibNames containsObject:nibName]) { + [self.registeredSupplementaryViewNibNames addObject:nibName]; + UINib *nib = [UINib nibWithNibName:nibName bundle:bundle]; + [collectionView registerNib:nib forSupplementaryViewOfKind:elementKind withReuseIdentifier:nibName]; + } + return [collectionView dequeueReusableSupplementaryViewOfKind:elementKind withReuseIdentifier:nibName forIndexPath:indexPath]; +} + +- (void)performBatchAnimated:(BOOL)animated updates:(void (^)(id))updates completion:(void (^)(BOOL))completion { + IGAssertMainThread(); + IGParameterAssert(updates != nil); + IGAssert(self.collectionView != nil, @"Performing batch updates without a collection view."); + + [self _enterBatchUpdates]; + __weak __typeof__(self) weakSelf = self; + [self.updater performUpdateWithCollectionViewBlock:[self _collectionViewBlock] animated:animated itemUpdates:^{ + weakSelf.isInUpdateBlock = YES; + // the adapter acts as the batch context with its API stripped to just the IGListBatchContext protocol + updates(weakSelf); + weakSelf.isInUpdateBlock = NO; + } completion: ^(BOOL finished) { + [weakSelf _updateBackgroundViewShouldHide:![weakSelf _itemCountIsZero]]; + [weakSelf _notifyDidUpdate:IGListAdapterUpdateTypeItemUpdates animated:animated]; + if (completion) { + completion(finished); + } + [weakSelf _exitBatchUpdates]; + }]; +} + +- (void)scrollToSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index + scrollPosition:(UICollectionViewScrollPosition)scrollPosition + animated:(BOOL)animated { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + + NSIndexPath *indexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + [self.collectionView scrollToItemAtIndexPath:indexPath atScrollPosition:scrollPosition animated:animated]; +} + +- (void)invalidateLayoutForSectionController:(IGListSectionController *)sectionController + completion:(void (^)(BOOL finished))completion{ + const NSInteger section = [self sectionForSectionController:sectionController]; + const NSInteger items = [_collectionView numberOfItemsInSection:section]; + + NSMutableArray *indexPaths = [NSMutableArray new]; + for (NSInteger item = 0; item < items; item++) { + [indexPaths addObject:[NSIndexPath indexPathForItem:item inSection:section]]; + } + + UICollectionViewLayout *layout = _collectionView.collectionViewLayout; + UICollectionViewLayoutInvalidationContext *context = [[[layout.class invalidationContextClass] alloc] init]; + [context invalidateItemsAtIndexPaths:indexPaths]; + + __weak __typeof__(_collectionView) weakCollectionView = _collectionView; + + // do not call -[UICollectionView performBatchUpdates:completion:] while already updating. defer it until completed. + [self _deferBlockBetweenBatchUpdates:^{ + [weakCollectionView performBatchUpdates:^{ + [layout invalidateLayoutWithContext:context]; + } completion:completion]; + }]; +} + +#pragma mark - IGListBatchContext + +- (void)reloadInSectionController:(IGListSectionController *)sectionController atIndexes:(NSIndexSet *)indexes { + IGAssertMainThread(); + IGParameterAssert(indexes != nil); + IGParameterAssert(sectionController != nil); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Tried to reload the adapter from %@ without a collection view at indexes %@.", sectionController, indexes); + + if (indexes.count == 0) { + return; + } + + /** + UICollectionView is not designed to support -reloadSections: or -reloadItemsAtIndexPaths: during batch updates. + Internally it appears to convert these operations to a delete+insert. However the transformation is too simple + in that it doesn't account for the item's section being moved (naturally or explicitly) and can queue animation + collisions. + + If you have an object at section 2 with 4 items and attempt to reload item at index 1, you would create an + NSIndexPath at section: 2, item: 1. Within -performBatchUpdates:, UICollectionView converts this to a delete + and insert at the same NSIndexPath. + + If a section were inserted at position 2, the original section 2 has naturally shifted to section 3. However, + the insert NSIndexPath is section: 2, item: 1. Now the UICollectionView has a section animation at section 2, + as well as an item insert animation at section: 2, item: 1, and it will throw an exception. + + IGListAdapter tracks the before/after mapping of section controllers to make precise NSIndexPath conversions. + */ + [indexes enumerateIndexesUsingBlock:^(NSUInteger index, BOOL *stop) { + NSIndexPath *fromIndexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:YES]; + NSIndexPath *toIndexPath = [self indexPathForSectionController:sectionController index:index usePreviousIfInUpdateBlock:NO]; + // index paths could be nil if a section controller is prematurely reloading or a reload was batched with + // the section controller being deleted + if (fromIndexPath != nil && toIndexPath != nil) { + [self.updater reloadItemInCollectionView:collectionView fromIndexPath:fromIndexPath toIndexPath:toIndexPath]; + } + }]; +} + +- (void)insertInSectionController:(IGListSectionController *)sectionController atIndexes:(NSIndexSet *)indexes { + IGAssertMainThread(); + IGParameterAssert(indexes != nil); + IGParameterAssert(sectionController != nil); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Inserting items from %@ without a collection view at indexes %@.", sectionController, indexes); + + if (indexes.count == 0) { + return; + } + + NSArray *indexPaths = [self indexPathsFromSectionController:sectionController indexes:indexes usePreviousIfInUpdateBlock:NO]; + [self.updater insertItemsIntoCollectionView:collectionView indexPaths:indexPaths]; + [self _updateBackgroundViewShouldHide:![self _itemCountIsZero]]; +} + +- (void)deleteInSectionController:(IGListSectionController *)sectionController atIndexes:(NSIndexSet *)indexes { + IGAssertMainThread(); + IGParameterAssert(indexes != nil); + IGParameterAssert(sectionController != nil); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Deleting items from %@ without a collection view at indexes %@.", sectionController, indexes); + + if (indexes.count == 0) { + return; + } + + NSArray *indexPaths = [self indexPathsFromSectionController:sectionController indexes:indexes usePreviousIfInUpdateBlock:YES]; + [self.updater deleteItemsFromCollectionView:collectionView indexPaths:indexPaths]; + [self _updateBackgroundViewShouldHide:![self _itemCountIsZero]]; +} + +- (void)invalidateLayoutInSectionController:(IGListSectionController *)sectionController atIndexes:(NSIndexSet *)indexes { + IGAssertMainThread(); + IGParameterAssert(indexes != nil); + IGParameterAssert(sectionController != nil); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Invalidating items from %@ without a collection view at indexes %@.", sectionController, indexes); + + if (indexes.count == 0) { + return; + } + + NSArray *indexPaths = [self indexPathsFromSectionController:sectionController indexes:indexes usePreviousIfInUpdateBlock:NO]; + UICollectionViewLayout *layout = collectionView.collectionViewLayout; + UICollectionViewLayoutInvalidationContext *context = [[[layout.class invalidationContextClass] alloc] init]; + [context invalidateItemsAtIndexPaths:indexPaths]; + [layout invalidateLayoutWithContext:context]; +} + +- (void)moveInSectionController:(IGListSectionController *)sectionController fromIndex:(NSInteger)fromIndex toIndex:(NSInteger)toIndex { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + IGParameterAssert(fromIndex >= 0); + IGParameterAssert(toIndex >= 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Moving items from %@ without a collection view from index %li to index %li.", + sectionController, (long)fromIndex, (long)toIndex); + + NSIndexPath *fromIndexPath = [self indexPathForSectionController:sectionController index:fromIndex usePreviousIfInUpdateBlock:YES]; + NSIndexPath *toIndexPath = [self indexPathForSectionController:sectionController index:toIndex usePreviousIfInUpdateBlock:NO]; + + if (fromIndexPath == nil || toIndexPath == nil) { + return; + } + + [self.updater moveItemInCollectionView:collectionView fromIndexPath:fromIndexPath toIndexPath:toIndexPath]; +} + +- (void)reloadSectionController:(IGListSectionController *)sectionController { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Reloading items from %@ without a collection view.", sectionController); + + IGListSectionMap *map = [self _sectionMapUsingPreviousIfInUpdateBlock:YES]; + const NSInteger section = [map sectionForSectionController:sectionController]; + if (section == NSNotFound) { + return; + } + + NSIndexSet *sections = [NSIndexSet indexSetWithIndex:section]; + [self.updater reloadCollectionView:collectionView sections:sections]; + [self _updateBackgroundViewShouldHide:![self _itemCountIsZero]]; +} + +- (void)moveSectionControllerInteractive:(IGListSectionController *)sectionController + fromIndex:(NSInteger)fromIndex + toIndex:(NSInteger)toIndex NS_AVAILABLE_IOS(9_0) { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + IGParameterAssert(fromIndex >= 0); + IGParameterAssert(toIndex >= 0); + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Moving section %@ without a collection view from index %li to index %li.", + sectionController, (long)fromIndex, (long)toIndex); + IGAssert(self.moveDelegate != nil, @"Moving section %@ without a moveDelegate set", sectionController); + + if (fromIndex != toIndex) { + id dataSource = self.dataSource; + + NSArray *previousObjects = [self.sectionMap objects]; + + if (self.isLastInteractiveMoveToLastSectionIndex) { + self.isLastInteractiveMoveToLastSectionIndex = NO; + } + else if (fromIndex < toIndex) { + toIndex -= 1; + } + + NSMutableArray *mutObjects = [previousObjects mutableCopy]; + id object = [previousObjects objectAtIndex:fromIndex]; + [mutObjects removeObjectAtIndex:fromIndex]; + [mutObjects insertObject:object atIndex:toIndex]; + + NSArray *objects = [mutObjects copy]; + + // inform the data source to update its model + [self.moveDelegate listAdapter:self moveObject:object from:previousObjects to:objects]; + + // update our model based on that provided by the data source + NSArray> *updatedObjects = [dataSource objectsForListAdapter:self]; + [self _updateObjects:updatedObjects dataSource:dataSource]; + } + + // even if from and to index are equal, we need to perform the "move" + // iOS interactively moves items, not sections, so we might have actually moved the item + // to the end of the preceeding section or beginning of the following section + [self.updater moveSectionInCollectionView:collectionView fromIndex:fromIndex toIndex:toIndex]; +} + +- (void)moveInSectionControllerInteractive:(IGListSectionController *)sectionController + fromIndex:(NSInteger)fromIndex + toIndex:(NSInteger)toIndex NS_AVAILABLE_IOS(9_0) { + IGAssertMainThread(); + IGParameterAssert(sectionController != nil); + IGParameterAssert(fromIndex >= 0); + IGParameterAssert(toIndex >= 0); + + [sectionController moveObjectFromIndex:fromIndex toIndex:toIndex]; +} + +- (void)revertInvalidInteractiveMoveFromIndexPath:(NSIndexPath *)sourceIndexPath + toIndexPath:(NSIndexPath *)destinationIndexPath NS_AVAILABLE_IOS(9_0) { + UICollectionView *collectionView = self.collectionView; + IGAssert(collectionView != nil, @"Reverting move without a collection view from %@ to %@.", + sourceIndexPath, destinationIndexPath); + + // revert by moving back in the opposite direction + [collectionView moveItemAtIndexPath:destinationIndexPath toIndexPath:sourceIndexPath]; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterDataSource.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterDataSource.h new file mode 100644 index 0000000..3118c94 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterDataSource.h @@ -0,0 +1,64 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +@class IGListAdapter; +@class IGListSectionController; + +NS_ASSUME_NONNULL_BEGIN + +/** + Implement this protocol to provide data to an `IGListAdapter`. + */ +NS_SWIFT_NAME(ListAdapterDataSource) +@protocol IGListAdapterDataSource + +/** + Asks the data source for the objects to display in the list. + + @param listAdapter The list adapter requesting this information. + + @return An array of objects for the list. + */ +- (NSArray> *)objectsForListAdapter:(IGListAdapter *)listAdapter; + +/** + Asks the data source for a section controller for the specified object in the list. + + @param listAdapter The list adapter requesting this information. + @param object An object in the list. + + @return A new section controller instance that can be displayed in the list. + + @note New section controllers should be initialized here for objects when asked. You may pass any other data to + the section controller at this time. + + Section controllers are initialized for all objects whenever the `IGListAdapter` is created, updated, or reloaded. + Section controllers are reused when objects are moved or updated. Maintaining the `-[IGListDiffable diffIdentifier]` + guarantees this. + */ +- (IGListSectionController *)listAdapter:(IGListAdapter *)listAdapter sectionControllerForObject:(id)object; + +/** + Asks the data source for a view to use as the collection view background when the list is empty. + + @param listAdapter The list adapter requesting this information. + + @return A view to use as the collection view background, or `nil` if you don't want a background view. + + @note This method is called every time the list adapter is updated. You are free to return new views every time, + but for performance reasons you may want to retain the view and return it here. The infra is only responsible for + adding the background view and maintaining its visibility. + */ +- (nullable UIView *)emptyViewForListAdapter:(IGListAdapter *)listAdapter; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterDelegate.h new file mode 100644 index 0000000..0db122e --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterDelegate.h @@ -0,0 +1,40 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; + +NS_ASSUME_NONNULL_BEGIN + +/** + Conform to `IGListAdapterDelegate` to receive display events for objects in a list. + */ +NS_SWIFT_NAME(ListAdapterDelegate) +@protocol IGListAdapterDelegate + +/** + Notifies the delegate that a list object is about to be displayed. + + @param listAdapter The list adapter sending this information. + @param object The object that will display. + @param index The index of the object in the list. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter willDisplayObject:(id)object atIndex:(NSInteger)index; + +/** + Notifies the delegate that a list object is no longer being displayed. + + @param listAdapter The list adapter sending this information. + @param object The object that ended display. + @param index The index of the object in the list. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didEndDisplayingObject:(id)object atIndex:(NSInteger)index; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterMoveDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterMoveDelegate.h new file mode 100644 index 0000000..e46812e --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterMoveDelegate.h @@ -0,0 +1,35 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; + +NS_ASSUME_NONNULL_BEGIN + +/** + Conform to `IGListAdapterMoveDelegate` to receive interactive reordering requests. + */ +NS_SWIFT_NAME(ListAdapterMoveDelegate) +@protocol IGListAdapterMoveDelegate + +/** + Asks the delegate to move a section object as the result of interactive reordering. + + @param listAdapter The list adapter sending this information. + @param object the object that was moved + @param previousObjects The array of objects prior to the move. + @param objects The array of objects after the move. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter + moveObject:(id)object + from:(NSArray *)previousObjects + to:(NSArray *)objects; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterPerformanceDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterPerformanceDelegate.h new file mode 100644 index 0000000..aee811c --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterPerformanceDelegate.h @@ -0,0 +1,111 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; +@class IGListSectionController; + +NS_ASSUME_NONNULL_BEGIN + +/** + `IGListAdapterPerformanceDelegate` can be used to measure cell dequeue, display, size, and scroll callbacks. + */ +NS_SWIFT_NAME(ListAdapterPerformanceDelegate) +@protocol IGListAdapterPerformanceDelegate + +/** + Will call `-[IGListAdapter collectionView:cellForItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + */ +- (void)listAdapterWillCallDequeueCell:(IGListAdapter *)listAdapter; + +/** + Did finish calling `-[IGListAdapter collectionView:cellForItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + @param cell A cell that was dequeued. + @param sectionController The section controller providing the cell. + @param index Item index of the cell. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didCallDequeueCell:(UICollectionViewCell *)cell onSectionController:(IGListSectionController *)sectionController atIndex:(NSInteger)index; + +/** + Will call `-[IGListAdapter collectionView:willDisplayCell:forItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + */ +- (void)listAdapterWillCallDisplayCell:(IGListAdapter *)listAdapter; + +/** + Did finish calling `-[IGListAdapter collectionView:willDisplayCell:forItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + @param cell A cell that will be displayed. + @param sectionController The section controller for that cell. + @param index Item index of the cell. + + @note Keep in mind this also includes calling the `IGListAdapter`'s collectionViewDelegate and workingRangeHandler. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didCallDisplayCell:(UICollectionViewCell *)cell onSectionController:(IGListSectionController *)sectionController atIndex:(NSInteger)index; + +/** + Will call `-[IGListAdapter collectionView:didEndDisplayingCell:forItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + */ +- (void)listAdapterWillCallEndDisplayCell:(IGListAdapter *)listAdapter; + +/** + Did finish calling `-[IGListAdapter collectionView:didEndDisplayingCell:forItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + @param cell A cell that was displayed. + @param sectionController The section controller for that cell. + @param index Item index of the cell. + + @note Keep in mind this also includes calling the `IGListAdapter`'s collectionViewDelegate and workingRangeHandler. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didCallEndDisplayCell:(UICollectionViewCell *)cell onSectionController:(IGListSectionController *)sectionController atIndex:(NSInteger)index; + +/** + Will call `-[IGListAdapter collectionView:collectionViewLayout:sizeForItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + */ +- (void)listAdapterWillCallSize:(IGListAdapter *)listAdapter; + +/** + Did finish calling `-[IGListAdapter collectionView:collectionViewLayout:sizeForItemAtIndexPath:]`. + + @param listAdapter The list adapter sending this information. + @param sectionController The section controller providing the size. + @param index Item index used to calculate the size. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didCallSizeOnSectionController:(IGListSectionController *)sectionController atIndex:(NSInteger)index; + +/** + Will call `-[IGListAdapter scrollViewDidScroll:]`. + + @param listAdapter The list adapter sending this information. + */ +- (void)listAdapterWillCallScroll:(IGListAdapter *)listAdapter; + +/** + Did finish calling `-[IGListAdapter scrollViewDidScroll:]`. + + @param listAdapter The list adapter sending this information. + @param scrollView The scroll view backing the UICollectionView. + + @note Keep in mind this also includes calling the `IGListAdapter`'s scrollViewDelegate and all visible `IGListSectioControllers`. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didCallScroll:(UIScrollView *)scrollView; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdateListener.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdateListener.h new file mode 100644 index 0000000..bf698e5 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdateListener.h @@ -0,0 +1,56 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; + +NS_ASSUME_NONNULL_BEGIN + +/** + The type of update that was performed by an `IGListAdapter`. + */ +NS_SWIFT_NAME(ListAdapterUpdateType) +typedef NS_ENUM(NSInteger, IGListAdapterUpdateType) { + /** + `-[IGListAdapter performUpdatesAnimated:completion:]` was executed. + */ + IGListAdapterUpdateTypePerformUpdates, + /** + `-[IGListAdapter reloadDataWithCompletion:]` was executed. + */ + IGListAdapterUpdateTypeReloadData, + /** + `-[IGListCollectionContext performBatchAnimated:updates:completion:]` was executed by an `IGListSectionController`. + */ + IGListAdapterUpdateTypeItemUpdates, +}; + +/** + Conform to this protocol to receive events about `IGListAdapter` updates. + */ +NS_SWIFT_NAME(ListAdapterUpdateListener) +@protocol IGListAdapterUpdateListener + +/** + Notifies a listener that the listAdapter was updated. + + @param listAdapter The `IGListAdapter` that updated. + @param update The type of update executed. + @param animated A flag indicating if the update was animated. Always `NO` for `IGListAdapterUpdateTypeReloadData`. + + @note This event is sent before the completion block in `-[IGListAdapter performUpdatesAnimated:completion:]` and + `-[IGListAdapter reloadDataWithCompletion:]` is executed. This event is also delivered when an + `IGListSectionController` updates via `-[IGListCollectionContext performBatchAnimated:updates:completion:]`. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter + didFinishUpdate:(IGListAdapterUpdateType)update + animated:(BOOL)animated; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdater.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdater.h new file mode 100644 index 0000000..bf4bf8e --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdater.h @@ -0,0 +1,68 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import +#import +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + An `IGListAdapterUpdater` is a concrete type that conforms to `IGListUpdatingDelegate`. + It is an out-of-box updater for `IGListAdapter` objects to use. + + @note This updater performs re-entrant, coalesced updating for a list. It also uses a least-minimal diff + for calculating UI updates when `IGListAdapter` calls + `-performUpdateWithCollectionView:fromObjects:toObjects:completion:`. + */ +IGLK_SUBCLASSING_RESTRICTED +NS_SWIFT_NAME(ListAdapterUpdater) +@interface IGListAdapterUpdater : NSObject + +/** + The delegate that receives events with data on the performance of a transition. + */ +@property (nonatomic, weak) id delegate; + +/** + A flag indicating if a move should be treated as a "delete, then insert" operation. + */ +@property (nonatomic, assign) BOOL movesAsDeletesInserts; + +/** + A flag indicating that section reloads should be treated as item reloads, instead of converting them to "delete, then insert" operations. + This only applies if the number of items for the section is unchanged. + + @note If the number of items for the section is changed, we would fallback to the default behavior and convert it to "delete + insert", + because the collectionView can crash otherwise. + + Default is NO. + */ +@property (nonatomic, assign) BOOL preferItemReloadsForSectionReloads; + +/** + A flag indicating whether this updater should skip diffing and simply call + `reloadData` for updates when the collection view is not in a window. The default value is `YES`. + + @note This will result in better performance, but will not generate the same delegate + callbacks. If using a custom layout, it will not receive `prepareForCollectionViewUpdates:`. + + @warning On iOS < 8.3, this behavior is unsupported and will always be treated as `NO`. + */ +@property (nonatomic, assign) BOOL allowsBackgroundReloading; + +/** + A bitmask of experiments to conduct on the updater. + */ +@property (nonatomic, assign) IGListExperiment experiments; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdater.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdater.m new file mode 100644 index 0000000..04aa357 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdater.m @@ -0,0 +1,641 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListAdapterUpdater.h" +#import "IGListAdapterUpdaterInternal.h" + +#import + +#import "IGListArrayUtilsInternal.h" +#import "IGListIndexSetResultInternal.h" +#import "IGListMoveIndexPathInternal.h" +#import "IGListReloadIndexPath.h" +#import "UICollectionView+IGListBatchUpdateData.h" + +@implementation IGListAdapterUpdater + +- (instancetype)init { + IGAssertMainThread(); + + if (self = [super init]) { + // the default is to use animations unless NO is passed + _queuedUpdateIsAnimated = YES; + _completionBlocks = [NSMutableArray new]; + _batchUpdates = [IGListBatchUpdates new]; + _allowsBackgroundReloading = YES; + } + return self; +} + +#pragma mark - Private API + +- (BOOL)hasChanges { + return self.hasQueuedReloadData + || [self.batchUpdates hasChanges] + || self.fromObjects != nil + || self.toObjectsBlock != nil; +} + +- (void)performReloadDataWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock { + IGAssertMainThread(); + + id delegate = self.delegate; + void (^reloadUpdates)(void) = self.reloadUpdates; + IGListBatchUpdates *batchUpdates = self.batchUpdates; + NSMutableArray *completionBlocks = [self.completionBlocks mutableCopy]; + + [self cleanStateBeforeUpdates]; + + void (^executeCompletionBlocks)(BOOL) = ^(BOOL finished) { + for (IGListUpdatingCompletion block in completionBlocks) { + block(finished); + } + + self.state = IGListBatchUpdateStateIdle; + }; + + // bail early if the collection view has been deallocated in the time since the update was queued + UICollectionView *collectionView = collectionViewBlock(); + if (collectionView == nil) { + [self _cleanStateAfterUpdates]; + executeCompletionBlocks(NO); + return; + } + + // item updates must not send mutations to the collection view while we are reloading + self.state = IGListBatchUpdateStateExecutingBatchUpdateBlock; + + if (reloadUpdates) { + reloadUpdates(); + } + + // execute all stored item update blocks even if we are just calling reloadData. the actual collection view + // mutations will be discarded, but clients are encouraged to put their actual /data/ mutations inside the + // update block as well, so if we don't execute the block the changes will never happen + for (IGListItemUpdateBlock itemUpdateBlock in batchUpdates.itemUpdateBlocks) { + itemUpdateBlock(); + } + + // add any completion blocks from item updates. added after item blocks are executed in order to capture any + // re-entrant updates + [completionBlocks addObjectsFromArray:batchUpdates.itemCompletionBlocks]; + + self.state = IGListBatchUpdateStateExecutedBatchUpdateBlock; + + [self _cleanStateAfterUpdates]; + + [delegate listAdapterUpdater:self willReloadDataWithCollectionView:collectionView]; + [collectionView reloadData]; + [collectionView.collectionViewLayout invalidateLayout]; + [collectionView layoutIfNeeded]; + [delegate listAdapterUpdater:self didReloadDataWithCollectionView:collectionView]; + + executeCompletionBlocks(YES); +} + +- (void)performBatchUpdatesWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock { + IGAssertMainThread(); + IGAssert(self.state == IGListBatchUpdateStateIdle, @"Should not call batch updates when state isn't idle"); + + // create local variables so we can immediately clean our state but pass these items into the batch update block + id delegate = self.delegate; + NSArray *fromObjects = [self.fromObjects copy]; + IGListToObjectBlock toObjectsBlock = [self.toObjectsBlock copy]; + NSMutableArray *completionBlocks = [self.completionBlocks mutableCopy]; + void (^objectTransitionBlock)(NSArray *) = [self.objectTransitionBlock copy]; + const BOOL animated = self.queuedUpdateIsAnimated; + IGListBatchUpdates *batchUpdates = self.batchUpdates; + + // clean up all state so that new updates can be coalesced while the current update is in flight + [self cleanStateBeforeUpdates]; + + void (^executeCompletionBlocks)(BOOL) = ^(BOOL finished) { + self.applyingUpdateData = nil; + self.state = IGListBatchUpdateStateIdle; + + for (IGListUpdatingCompletion block in completionBlocks) { + block(finished); + } + }; + + // bail early if the collection view has been deallocated in the time since the update was queued + UICollectionView *collectionView = collectionViewBlock(); + if (collectionView == nil) { + [self _cleanStateAfterUpdates]; + executeCompletionBlocks(NO); + return; + } + + NSArray *toObjects = nil; + if (toObjectsBlock != nil) { + toObjects = objectsWithDuplicateIdentifiersRemoved(toObjectsBlock()); + } +#ifdef DEBUG + for (id obj in toObjects) { + IGAssert([obj conformsToProtocol:@protocol(IGListDiffable)], + @"In order to use IGListAdapterUpdater, object %@ must conform to IGListDiffable", obj); + IGAssert([obj diffIdentifier] != nil, + @"Cannot have a nil diffIdentifier for object %@", obj); + } +#endif + + void (^executeUpdateBlocks)(void) = ^{ + self.state = IGListBatchUpdateStateExecutingBatchUpdateBlock; + + // run the update block so that the adapter can set its items. this makes sure that just before the update is + // committed that the data source is updated to the /latest/ "toObjects". this makes the data source in sync + // with the items that the updater is transitioning to + if (objectTransitionBlock != nil) { + objectTransitionBlock(toObjects); + } + + // execute each item update block which should make calls like insert, delete, and reload for index paths + // we collect all mutations in corresponding sets on self, then filter based on UICollectionView shortcomings + // call after the objectTransitionBlock so section level mutations happen before any items + for (IGListItemUpdateBlock itemUpdateBlock in batchUpdates.itemUpdateBlocks) { + itemUpdateBlock(); + } + + // add any completion blocks from item updates. added after item blocks are executed in order to capture any + // re-entrant updates + [completionBlocks addObjectsFromArray:batchUpdates.itemCompletionBlocks]; + + self.state = IGListBatchUpdateStateExecutedBatchUpdateBlock; + }; + + void (^reloadDataFallback)(void) = ^{ + executeUpdateBlocks(); + [self _cleanStateAfterUpdates]; + [self _performBatchUpdatesItemBlockApplied]; + [collectionView reloadData]; + [collectionView layoutIfNeeded]; + + executeCompletionBlocks(YES); + }; + + // if the collection view isn't in a visible window, skip diffing and batch updating. execute all transition blocks, + // reload data, execute completion blocks, and get outta here + if (self.allowsBackgroundReloading && collectionView.window == nil) { + [self _beginPerformBatchUpdatesToObjects:toObjects]; + reloadDataFallback(); + return; + } + + // disables multiple performBatchUpdates: from happening at the same time + [self _beginPerformBatchUpdatesToObjects:toObjects]; + + const IGListExperiment experiments = self.experiments; + + IGListIndexSetResult *(^performDiff)(void) = ^{ + return IGListDiffExperiment(fromObjects, toObjects, IGListDiffEquality, experiments); + }; + + // block executed in the first param block of -[UICollectionView performBatchUpdates:completion:] + void (^batchUpdatesBlock)(IGListIndexSetResult *result) = ^(IGListIndexSetResult *result){ + executeUpdateBlocks(); + + self.applyingUpdateData = [self _flushCollectionView:collectionView + withDiffResult:result + batchUpdates:self.batchUpdates + fromObjects:fromObjects]; + + [self _cleanStateAfterUpdates]; + [self _performBatchUpdatesItemBlockApplied]; + }; + + // block used as the second param of -[UICollectionView performBatchUpdates:completion:] + void (^batchUpdatesCompletionBlock)(BOOL) = ^(BOOL finished) { + IGListBatchUpdateData *oldApplyingUpdateData = self.applyingUpdateData; + executeCompletionBlocks(finished); + + [delegate listAdapterUpdater:self didPerformBatchUpdates:oldApplyingUpdateData collectionView:collectionView]; + + // queue another update in case something changed during batch updates. this method will bail next runloop if + // there are no changes + [self _queueUpdateWithCollectionViewBlock:collectionViewBlock]; + }; + + // block that executes the batch update and exception handling + void (^performUpdate)(IGListIndexSetResult *) = ^(IGListIndexSetResult *result){ + [collectionView layoutIfNeeded]; + + @try { + [delegate listAdapterUpdater:self +willPerformBatchUpdatesWithCollectionView:collectionView + fromObjects:fromObjects + toObjects:toObjects + listIndexSetResult:result]; + if (collectionView.dataSource == nil) { + // If the data source is nil, we should not call any collection view update. + batchUpdatesCompletionBlock(NO); + } else if (result.changeCount > 100 && IGListExperimentEnabled(experiments, IGListExperimentReloadDataFallback)) { + reloadDataFallback(); + } else if (animated) { + [collectionView performBatchUpdates:^{ + batchUpdatesBlock(result); + } completion:batchUpdatesCompletionBlock]; + } else { + [CATransaction begin]; + [CATransaction setDisableActions:YES]; + [collectionView performBatchUpdates:^{ + batchUpdatesBlock(result); + } completion:^(BOOL finished) { + [CATransaction commit]; + batchUpdatesCompletionBlock(finished); + }]; + } + } @catch (NSException *exception) { + [delegate listAdapterUpdater:self + collectionView:collectionView + willCrashWithException:exception + fromObjects:fromObjects + toObjects:toObjects + diffResult:result + updates:(id)self.applyingUpdateData]; + @throw exception; + } + }; + + if (IGListExperimentEnabled(experiments, IGListExperimentBackgroundDiffing)) { + dispatch_async(dispatch_get_global_queue(QOS_CLASS_USER_INITIATED, 0), ^{ + IGListIndexSetResult *result = performDiff(); + dispatch_async(dispatch_get_main_queue(), ^{ + performUpdate(result); + }); + }); + } else { + IGListIndexSetResult *result = performDiff(); + performUpdate(result); + } +} + +void convertReloadToDeleteInsert(NSMutableIndexSet *reloads, + NSMutableIndexSet *deletes, + NSMutableIndexSet *inserts, + IGListIndexSetResult *result, + NSArray> *fromObjects) { + // reloadSections: is unsafe to use within performBatchUpdates:, so instead convert all reloads into deletes+inserts + const BOOL hasObjects = [fromObjects count] > 0; + [[reloads copy] enumerateIndexesUsingBlock:^(NSUInteger idx, BOOL *stop) { + // if a diff was not performed, there are no changes. instead use the same index that was originally queued + id diffIdentifier = hasObjects ? [fromObjects[idx] diffIdentifier] : nil; + const NSInteger from = hasObjects ? [result oldIndexForIdentifier:diffIdentifier] : idx; + const NSInteger to = hasObjects ? [result newIndexForIdentifier:diffIdentifier] : idx; + [reloads removeIndex:from]; + + // if a reload is queued outside the diff and the object was inserted or deleted it cannot be + if (from != NSNotFound && to != NSNotFound) { + [deletes addIndex:from]; + [inserts addIndex:to]; + } else { + IGAssert([result.deletes containsIndex:idx], + @"Reloaded section %lu was not found in deletes with from: %li, to: %li, deletes: %@, fromClass: %@", + (unsigned long)idx, (long)from, (long)to, deletes, [(id)fromObjects[idx] class]); + } + }]; +} + +static NSArray *convertSectionReloadToItemUpdates(NSIndexSet *sectionReloads, UICollectionView *collectionView) { + NSMutableArray *updates = [NSMutableArray new]; + [sectionReloads enumerateIndexesUsingBlock:^(NSUInteger sectionIndex, BOOL * _Nonnull stop) { + NSUInteger numberOfItems = [collectionView numberOfItemsInSection:sectionIndex]; + for (NSUInteger itemIndex = 0; itemIndex < numberOfItems; itemIndex++) { + [updates addObject:[NSIndexPath indexPathForItem:itemIndex inSection:sectionIndex]]; + } + }]; + return [updates copy]; +} + +- (IGListBatchUpdateData *)_flushCollectionView:(UICollectionView *)collectionView + withDiffResult:(IGListIndexSetResult *)diffResult + batchUpdates:(IGListBatchUpdates *)batchUpdates + fromObjects:(NSArray > *)fromObjects { + NSSet *moves = [[NSSet alloc] initWithArray:diffResult.moves]; + + // combine section reloads from the diff and manual reloads via reloadItems: + NSMutableIndexSet *reloads = [diffResult.updates mutableCopy]; + [reloads addIndexes:batchUpdates.sectionReloads]; + + NSMutableIndexSet *inserts = [diffResult.inserts mutableCopy]; + NSMutableIndexSet *deletes = [diffResult.deletes mutableCopy]; + NSMutableArray *itemUpdates = [NSMutableArray new]; + if (self.movesAsDeletesInserts) { + for (IGListMoveIndex *move in moves) { + [deletes addIndex:move.from]; + [inserts addIndex:move.to]; + } + // clear out all moves + moves = [NSSet new]; + } + + // Item reloads are not safe, if any section moves happened or there are inserts/deletes. + if (self.preferItemReloadsForSectionReloads + && moves.count == 0 && inserts.count == 0 && deletes.count == 0 && reloads.count > 0) { + [reloads enumerateIndexesUsingBlock:^(NSUInteger sectionIndex, BOOL * _Nonnull stop) { + NSMutableIndexSet *localIndexSet = [NSMutableIndexSet indexSetWithIndex:sectionIndex]; + if (sectionIndex < [collectionView numberOfSections] + && sectionIndex < [collectionView.dataSource numberOfSectionsInCollectionView:collectionView] + && [collectionView numberOfItemsInSection:sectionIndex] == [collectionView.dataSource collectionView:collectionView numberOfItemsInSection:sectionIndex]) { + // Perfer to do item reloads instead, if the number of items in section is unchanged. + [itemUpdates addObjectsFromArray:convertSectionReloadToItemUpdates(localIndexSet, collectionView)]; + } else { + // Otherwise, fallback to convert into delete+insert section operation. + convertReloadToDeleteInsert(localIndexSet, deletes, inserts, diffResult, fromObjects); + } + }]; + } else { + // reloadSections: is unsafe to use within performBatchUpdates:, so instead convert all reloads into deletes+inserts + convertReloadToDeleteInsert(reloads, deletes, inserts, diffResult, fromObjects); + } + + NSMutableArray *itemInserts = batchUpdates.itemInserts; + NSMutableArray *itemDeletes = batchUpdates.itemDeletes; + NSMutableArray *itemMoves = batchUpdates.itemMoves; + + NSSet *uniqueDeletes = [NSSet setWithArray:itemDeletes]; + NSMutableSet *reloadDeletePaths = [NSMutableSet new]; + NSMutableSet *reloadInsertPaths = [NSMutableSet new]; + for (IGListReloadIndexPath *reload in batchUpdates.itemReloads) { + if (![uniqueDeletes containsObject:reload.fromIndexPath]) { + [reloadDeletePaths addObject:reload.fromIndexPath]; + [reloadInsertPaths addObject:reload.toIndexPath]; + } + } + [itemDeletes addObjectsFromArray:[reloadDeletePaths allObjects]]; + [itemInserts addObjectsFromArray:[reloadInsertPaths allObjects]]; + + const BOOL fixIndexPathImbalance = IGListExperimentEnabled(self.experiments, IGListExperimentFixIndexPathImbalance); + IGListBatchUpdateData *updateData = [[IGListBatchUpdateData alloc] initWithInsertSections:inserts + deleteSections:deletes + moveSections:moves + insertIndexPaths:itemInserts + deleteIndexPaths:itemDeletes + updateIndexPaths:itemUpdates + moveIndexPaths:itemMoves + fixIndexPathImbalance:fixIndexPathImbalance]; + [collectionView ig_applyBatchUpdateData:updateData]; + return updateData; +} + +- (void)_beginPerformBatchUpdatesToObjects:(NSArray *)toObjects { + self.pendingTransitionToObjects = toObjects; + self.state = IGListBatchUpdateStateQueuedBatchUpdate; +} + +- (void)_performBatchUpdatesItemBlockApplied { + self.pendingTransitionToObjects = nil; +} + +- (void)cleanStateBeforeUpdates { + self.queuedUpdateIsAnimated = YES; + + // destroy to/from transition items + self.fromObjects = nil; + self.toObjectsBlock = nil; + + // destroy reloadData state + self.reloadUpdates = nil; + self.queuedReloadData = NO; + + // remove indexpath/item changes + self.objectTransitionBlock = nil; + + // removes all object completion blocks. done before updates to start collecting completion blocks for coalesced + // or re-entrant object updates + [self.completionBlocks removeAllObjects]; +} + +- (void)_cleanStateAfterUpdates { + self.batchUpdates = [IGListBatchUpdates new]; +} + +- (void)_queueUpdateWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock { + IGAssertMainThread(); + + __weak __typeof__(self) weakSelf = self; + + // dispatch_async to give the main queue time to collect more batch updates so that a minimum amount of work + // (diffing, etc) is done on main. dispatch_async does not garauntee a full runloop turn will pass though. + // see -performUpdateWithCollectionView:fromObjects:toObjects:animated:objectTransitionBlock:completion: for more + // details on how coalescence is done. + dispatch_async(dispatch_get_main_queue(), ^{ + if (weakSelf.state != IGListBatchUpdateStateIdle + || ![weakSelf hasChanges]) { + return; + } + + if (weakSelf.hasQueuedReloadData) { + [weakSelf performReloadDataWithCollectionViewBlock:collectionViewBlock]; + } else { + [weakSelf performBatchUpdatesWithCollectionViewBlock:collectionViewBlock]; + } + }); +} + + +#pragma mark - IGListUpdatingDelegate + +static BOOL IGListIsEqual(const void *a, const void *b, NSUInteger (*size)(const void *item)) { + const id left = (__bridge id)a; + const id right = (__bridge id)b; + return [left class] == [right class] + && [[left diffIdentifier] isEqual:[right diffIdentifier]]; +} + +// since the diffing algo used in this updater keys items based on their -diffIdentifier, we must use a map table that +// precisely mimics this behavior +static NSUInteger IGListIdentifierHash(const void *item, NSUInteger (*size)(const void *item)) { + return [[(__bridge id)item diffIdentifier] hash]; +} + +- (NSPointerFunctions *)objectLookupPointerFunctions { + NSPointerFunctions *functions = [NSPointerFunctions pointerFunctionsWithOptions:NSPointerFunctionsStrongMemory]; + functions.hashFunction = IGListIdentifierHash; + functions.isEqualFunction = IGListIsEqual; + return functions; +} + +- (void)performUpdateWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + fromObjects:(NSArray *)fromObjects + toObjectsBlock:(IGListToObjectBlock)toObjectsBlock + animated:(BOOL)animated + objectTransitionBlock:(IGListObjectTransitionBlock)objectTransitionBlock + completion:(IGListUpdatingCompletion)completion { + IGAssertMainThread(); + IGParameterAssert(collectionViewBlock != nil); + IGParameterAssert(objectTransitionBlock != nil); + + // only update the items that we are coming from if it has not been set + // this allows multiple updates to be called while an update is already in progress, and the transition from > to + // will be done on the first "fromObjects" received and the last "toObjects" + // if performBatchUpdates: hasn't applied the update block, then data source hasn't transitioned its state. if an + // update is queued in between then we must use the pending toObjects + self.fromObjects = self.fromObjects ?: self.pendingTransitionToObjects ?: fromObjects; + self.toObjectsBlock = toObjectsBlock; + + // disabled animations will always take priority + // reset to YES in -cleanupState + self.queuedUpdateIsAnimated = self.queuedUpdateIsAnimated && animated; + + // always use the last update block, even though this should always do the exact same thing + self.objectTransitionBlock = objectTransitionBlock; + + IGListUpdatingCompletion localCompletion = completion; + if (localCompletion) { + [self.completionBlocks addObject:localCompletion]; + } + + [self _queueUpdateWithCollectionViewBlock:collectionViewBlock]; +} + +- (void)performUpdateWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + animated:(BOOL)animated + itemUpdates:(void (^)(void))itemUpdates + completion:(void (^)(BOOL))completion { + IGAssertMainThread(); + IGParameterAssert(collectionViewBlock != nil); + IGParameterAssert(itemUpdates != nil); + + IGListBatchUpdates *batchUpdates = self.batchUpdates; + if (completion != nil) { + [batchUpdates.itemCompletionBlocks addObject:completion]; + } + + // if already inside the execution of the update block, immediately unload the itemUpdates block. + // the completion blocks are executed later in the lifecycle, so that still needs to be added to the batch + if (self.state == IGListBatchUpdateStateExecutingBatchUpdateBlock) { + itemUpdates(); + } else { + [batchUpdates.itemUpdateBlocks addObject:itemUpdates]; + + // disabled animations will always take priority + // reset to YES in -cleanupState + self.queuedUpdateIsAnimated = self.queuedUpdateIsAnimated && animated; + + [self _queueUpdateWithCollectionViewBlock:collectionViewBlock]; + } +} + +- (void)insertItemsIntoCollectionView:(UICollectionView *)collectionView indexPaths:(NSArray *)indexPaths { + IGAssertMainThread(); + IGParameterAssert(collectionView != nil); + IGParameterAssert(indexPaths != nil); + if (self.state == IGListBatchUpdateStateExecutingBatchUpdateBlock) { + [self.batchUpdates.itemInserts addObjectsFromArray:indexPaths]; + } else { + [self.delegate listAdapterUpdater:self willInsertIndexPaths:indexPaths collectionView:collectionView]; + [collectionView insertItemsAtIndexPaths:indexPaths]; + } +} + +- (void)deleteItemsFromCollectionView:(UICollectionView *)collectionView indexPaths:(NSArray *)indexPaths { + IGAssertMainThread(); + IGParameterAssert(collectionView != nil); + IGParameterAssert(indexPaths != nil); + if (self.state == IGListBatchUpdateStateExecutingBatchUpdateBlock) { + [self.batchUpdates.itemDeletes addObjectsFromArray:indexPaths]; + } else { + [self.delegate listAdapterUpdater:self willDeleteIndexPaths:indexPaths collectionView:collectionView]; + [collectionView deleteItemsAtIndexPaths:indexPaths]; + } +} + +- (void)moveItemInCollectionView:(UICollectionView *)collectionView + fromIndexPath:(NSIndexPath *)fromIndexPath + toIndexPath:(NSIndexPath *)toIndexPath { + if (self.state == IGListBatchUpdateStateExecutingBatchUpdateBlock) { + IGListMoveIndexPath *move = [[IGListMoveIndexPath alloc] initWithFrom:fromIndexPath to:toIndexPath]; + [self.batchUpdates.itemMoves addObject:move]; + } else { + [self.delegate listAdapterUpdater:self willMoveFromIndexPath:fromIndexPath toIndexPath:toIndexPath collectionView:collectionView]; + [collectionView moveItemAtIndexPath:fromIndexPath toIndexPath:toIndexPath]; + } +} + +- (void)reloadItemInCollectionView:(UICollectionView *)collectionView + fromIndexPath:(NSIndexPath *)fromIndexPath + toIndexPath:(NSIndexPath *)toIndexPath { + if (self.state == IGListBatchUpdateStateExecutingBatchUpdateBlock) { + IGListReloadIndexPath *reload = [[IGListReloadIndexPath alloc] initWithFromIndexPath:fromIndexPath toIndexPath:toIndexPath]; + [self.batchUpdates.itemReloads addObject:reload]; + } else { + [self.delegate listAdapterUpdater:self willReloadIndexPaths:@[fromIndexPath] collectionView:collectionView]; + [collectionView reloadItemsAtIndexPaths:@[fromIndexPath]]; + } +} + +- (void)moveSectionInCollectionView:(UICollectionView *)collectionView + fromIndex:(NSInteger)fromIndex + toIndex:(NSInteger)toIndex { + IGAssertMainThread(); + IGParameterAssert(collectionView != nil); + + // iOS expects interactive reordering to be movement of items not sections + // after moving a single-item section controller, + // you end up with two items in the section for the drop location, + // and zero items in the section originating at the drag location + // so, we have to reload data rather than doing a section move + + [collectionView reloadData]; + + // It seems that reloadData called during UICollectionView's moveItemAtIndexPath + // delegate call does not reload all cells as intended + // So, we further reload all visible sections to make sure none of our cells + // are left with data that's out of sync with our dataSource + + id delegate = self.delegate; + + NSMutableIndexSet *visibleSections = [NSMutableIndexSet new]; + NSArray *visibleIndexPaths = [collectionView indexPathsForVisibleItems]; + for (NSIndexPath *visibleIndexPath in visibleIndexPaths) { + [visibleSections addIndex:visibleIndexPath.section]; + } + + [delegate listAdapterUpdater:self willReloadSections:visibleSections collectionView:collectionView]; + + // prevent double-animation from reloadData + reloadSections + + [CATransaction begin]; + [CATransaction setDisableActions:YES]; + [collectionView performBatchUpdates:^{ + [collectionView reloadSections:visibleSections]; + } completion:^(BOOL finished) { + [CATransaction commit]; + }]; +} + +- (void)reloadDataWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + reloadUpdateBlock:(IGListReloadUpdateBlock)reloadUpdateBlock + completion:(nullable IGListUpdatingCompletion)completion { + IGAssertMainThread(); + IGParameterAssert(collectionViewBlock != nil); + IGParameterAssert(reloadUpdateBlock != nil); + + IGListUpdatingCompletion localCompletion = completion; + if (localCompletion) { + [self.completionBlocks addObject:localCompletion]; + } + + self.reloadUpdates = reloadUpdateBlock; + self.queuedReloadData = YES; + [self _queueUpdateWithCollectionViewBlock:collectionViewBlock]; +} + +- (void)reloadCollectionView:(UICollectionView *)collectionView sections:(NSIndexSet *)sections { + IGAssertMainThread(); + IGParameterAssert(collectionView != nil); + IGParameterAssert(sections != nil); + if (self.state == IGListBatchUpdateStateExecutingBatchUpdateBlock) { + [self.batchUpdates.sectionReloads addIndexes:sections]; + } else { + [self.delegate listAdapterUpdater:self willReloadSections:sections collectionView:collectionView]; + [collectionView reloadSections:sections]; + } +} + + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdaterDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdaterDelegate.h new file mode 100644 index 0000000..15384b9 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListAdapterUpdaterDelegate.h @@ -0,0 +1,157 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +@class IGListAdapterUpdater; +@class IGListBatchUpdates; +@class IGListIndexSetResult; +@protocol IGListDiffable; + +NS_ASSUME_NONNULL_BEGIN + +/** + A protocol that receives events about `IGListAdapterUpdater` operations. + */ +NS_SWIFT_NAME(ListAdapterUpdaterDelegate) +@protocol IGListAdapterUpdaterDelegate + +/** + Notifies the delegate that the updater will call `-[UICollectionView performBatchUpdates:completion:]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param collectionView The collection view that will perform the batch updates. + @param fromObjects The items transitioned from in the batch updates, if any. + @param toObjects The items transitioned to in the batch updates, if any. + @param listIndexSetResults The diffing result of indices to be inserted/removed/updated/moved/etc. + */ +- (void) listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater +willPerformBatchUpdatesWithCollectionView:(UICollectionView *)collectionView + fromObjects:(nullable NSArray > *)fromObjects + toObjects:(nullable NSArray > *)toObjects + listIndexSetResult:(nullable IGListIndexSetResult *)listIndexSetResults; + +/** + Notifies the delegate that the updater successfully finished `-[UICollectionView performBatchUpdates:completion:]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param updates The batch updates that were applied to the collection view. + @param collectionView The collection view that performed the batch updates. + + @note This event is called in the completion block of the batch update. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater + didPerformBatchUpdates:(IGListBatchUpdateData *)updates + collectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the updater will call `-[UICollectionView insertItemsAtIndexPaths:]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param indexPaths An array of index paths that will be inserted. + @param collectionView The collection view that will perform the insert. + + @note This event is only sent when outside of `-[UICollectionView performBatchUpdates:completion:]`. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater + willInsertIndexPaths:(NSArray *)indexPaths + collectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the updater will call `-[UICollectionView deleteItemsAtIndexPaths:]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param indexPaths An array of index paths that will be deleted. + @param collectionView The collection view that will perform the delete. + + @note This event is only sent when outside of `-[UICollectionView performBatchUpdates:completion:]`. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater + willDeleteIndexPaths:(NSArray *)indexPaths + collectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the updater will call `-[UICollectionView moveItemAtIndexPath:toIndexPath:]` + + @param listAdapterUpdater The adapter updater owning the transition. + @param fromIndexPath The index path of the item that will be moved. + @param toIndexPath The index path to move the item to. + @param collectionView The collection view that will perform the move. + + @note This event is only sent when outside of `-[UICollectionView performBatchUpdates:completion:]`. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater + willMoveFromIndexPath:(NSIndexPath *)fromIndexPath + toIndexPath:(NSIndexPath *)toIndexPath + collectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the updater will call `-[UICollectionView reloadItemsAtIndexPaths:]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param indexPaths An array of index paths that will be reloaded. + @param collectionView The collection view that will perform the reload. + + @note This event is only sent when outside of `-[UICollectionView performBatchUpdates:completion:]`. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater + willReloadIndexPaths:(NSArray *)indexPaths + collectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the updater will call `-[UICollectionView reloadSections:]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param sections The sections that will be reloaded + @param collectionView The collection view that will perform the reload. + + @note This event is only sent when outside of `-[UICollectionView performBatchUpdates:completion:]`. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater + willReloadSections:(NSIndexSet *)sections + collectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the updater will call `-[UICollectionView reloadData]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param collectionView The collection view that will be reloaded. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater willReloadDataWithCollectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the updater successfully called `-[UICollectionView reloadData]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param collectionView The collection view that reloaded. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater didReloadDataWithCollectionView:(UICollectionView *)collectionView; + +/** + Notifies the delegate that the collection view threw an exception in `-[UICollectionView performBatchUpdates:completion:]`. + + @param listAdapterUpdater The adapter updater owning the transition. + @param collectionView The collection view being updated. + @param exception The exception thrown by the collection view. + @param fromObjects The items transitioned from in the diff, if any. + @param toObjects The items transitioned to in the diff, if any. + @param diffResult The diff result that were computed from `fromObjects` and `toObjects`. + @param updates The batch updates that were applied to the collection view. + */ +- (void)listAdapterUpdater:(IGListAdapterUpdater *)listAdapterUpdater + collectionView:(UICollectionView *)collectionView + willCrashWithException:(NSException *)exception + fromObjects:(nullable NSArray *)fromObjects + toObjects:(nullable NSArray *)toObjects + diffResult:(IGListIndexSetResult *)diffResult + updates:(IGListBatchUpdateData *)updates; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListBatchContext.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListBatchContext.h new file mode 100644 index 0000000..59f166a --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListBatchContext.h @@ -0,0 +1,109 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListSectionController; + + + +NS_ASSUME_NONNULL_BEGIN + +/** + Objects conforming to the IGListBatchContext protocol provide a way for section controllers to mutate their cells or + reload everything within the section. + */ +NS_SWIFT_NAME(ListBatchContext) +@protocol IGListBatchContext + +/** + Reloads cells in the section controller. + + @param sectionController The section controller who's cells need reloading. + @param indexes The indexes of items that need reloading. + */ +- (void)reloadInSectionController:(IGListSectionController *)sectionController + atIndexes:(NSIndexSet *)indexes; + +/** + Inserts cells in the list. + + @param sectionController The section controller who's cells need inserting. + @param indexes The indexes of items that need inserting. + */ +- (void)insertInSectionController:(IGListSectionController *)sectionController + atIndexes:(NSIndexSet *)indexes; + +/** + Deletes cells in the list. + + @param sectionController The section controller who's cells need deleted. + @param indexes The indexes of items that need deleting. + */ +- (void)deleteInSectionController:(IGListSectionController *)sectionController + atIndexes:(NSIndexSet *)indexes; + +/** + Invalidates layouts of cells at specific in the section controller. + + @param sectionController The section controller who's cells need invalidating. + @param indexes The indexes of items that need invalidating. + */ +- (void)invalidateLayoutInSectionController:(IGListSectionController *)sectionController + atIndexes:(NSIndexSet *)indexes; + +/** + Moves a cell from one index to another within the section controller. + + @param sectionController The section controller who's cell needs moved. + @param fromIndex The index the cell is currently in. + @param toIndex The index the cell should move to. + */ +- (void)moveInSectionController:(IGListSectionController *)sectionController + fromIndex:(NSInteger)fromIndex + toIndex:(NSInteger)toIndex; + +/** + Reloads the entire section controller. + + @param sectionController The section controller who's cells need reloading. + */ +- (void)reloadSectionController:(IGListSectionController *)sectionController; + +/** + Moves a section controller from one index to another during interactive reordering. + + @param sectionController The section controller to move. + @param fromIndex The index where the section currently resides. + @param toIndex The index the section should move to. + */ +- (void)moveSectionControllerInteractive:(IGListSectionController *)sectionController + fromIndex:(NSInteger)fromIndex + toIndex:(NSInteger)toIndex NS_AVAILABLE_IOS(9_0); + +/** + Moves an object within a section controller from one index to another during interactive reordering. + + @param sectionController The section controller containing the object to move. + @param fromIndex The index where the object currently resides. + @param toIndex The index the object should move to. + */ +- (void)moveInSectionControllerInteractive:(IGListSectionController *)sectionController + fromIndex:(NSInteger)fromIndex + toIndex:(NSInteger)toIndex NS_AVAILABLE_IOS(9_0); + +/** + Reverts an move from one indexPath to another during interactive reordering. + + @param sourceIndexPath The indexPath the item was originally in. + @param destinationIndexPath The indexPath the item was moving to. + */ +- (void)revertInvalidInteractiveMoveFromIndexPath:(NSIndexPath *)sourceIndexPath + toIndexPath:(NSIndexPath *)destinationIndexPath NS_AVAILABLE_IOS(9_0); +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListBindable.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindable.h new file mode 100644 index 0000000..29d1e50 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindable.h @@ -0,0 +1,30 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + A protocol for cells that configure themselves given a view model. + */ +NS_SWIFT_NAME(ListBindable) +@protocol IGListBindable + +/** + Tells the cell to configure itself with the given view model. + + @param viewModel The view model for the cell. + + @note The view model can change many times throughout the lifetime of a cell as the model values change and the cell + is reused. Implementations should use only this method to do their configuration. + */ +- (void)bindViewModel:(id)viewModel; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionController.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionController.h new file mode 100644 index 0000000..3c3dac9 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionController.h @@ -0,0 +1,91 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import +#import +#import + +@protocol IGListDiffable; +@protocol IGListBindable; + +@class IGListBindingSectionController; + +NS_ASSUME_NONNULL_BEGIN + +/** + This section controller uses a data source to transform its "top level" object into an array of diffable view models. + It then automatically binds each view model to cells via the `IGListBindable` protocol. + + Models used with `IGListBindingSectionController` should take special care to always return `YES` for identical + objects. That is, any objects with matching `-diffIdentifier`s should always be equal, that way the section controller + can create new view models via the data source, create a diff, and update the specific cells that have changed. + + In Objective-C, your `-isEqualToDiffableObject:` can simply be: + ``` + - (BOOL)isEqualToDiffableObject:(id)object { + return YES; + } + ``` + + In Swift: + ``` + func isEqual(toDiffableObject object: IGListDiffable?) -> Bool { + return true + } + ``` + + Only when `-diffIdentifier`s match is object equality compared, so you can assume the class is the same, and the + instance has already been checked. + */ +NS_SWIFT_NAME(ListBindingSectionController) +@interface IGListBindingSectionController<__covariant ObjectType : id> : IGListSectionController + +/** + A data source that transforms a top-level object into view models, and returns cells and sizes for given view models. + */ +@property (nonatomic, weak, nullable) id dataSource; + +/** + A delegate that receives selection events from cells in an `IGListBindingSectionController` instance. + */ +@property (nonatomic, weak, nullable) id selectionDelegate; + +/** + The object currently assigned to the section controller, if any. + */ +@property (nonatomic, strong, readonly, nullable) ObjectType object; + +/** + The array of view models created from the data source. Values are changed when the top-level object changes or by + calling `-updateAnimated:completion:` manually. + */ +@property (nonatomic, strong, readonly) NSArray> *viewModels; + +/** + Tells the section controller to query for new view models, diff the changes, and update its cells. + + @param animated A flag indicating if the transition should be animated or not. + @param completion An optional completion block executed after updates finish. Parameter is YES if updates were applied. + */ +- (void)updateAnimated:(BOOL)animated completion:(nullable void (^)(BOOL updated))completion; + +/** + Notifies the section that a list object should move within a section as the result of interactive reordering. + + @param sourceIndex The starting index of the object. + @param destinationIndex The ending index of the object. + + @note this method must be implemented if interactive reordering is enabled. To ensure updating the internal viewModels array, **calling super is required**, preferably before your own implementation. + */ +- (void)moveObjectFromIndex:(NSInteger)sourceIndex toIndex:(NSInteger)destinationIndex NS_REQUIRES_SUPER; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionController.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionController.m new file mode 100644 index 0000000..85c9b3e --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionController.m @@ -0,0 +1,153 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListBindingSectionController.h" + +#import +#import + +#import "IGListArrayUtilsInternal.h" + +typedef NS_ENUM(NSInteger, IGListDiffingSectionState) { + IGListDiffingSectionStateIdle = 0, + IGListDiffingSectionStateUpdateQueued, + IGListDiffingSectionStateUpdateApplied +}; + +@interface IGListBindingSectionController() + +@property (nonatomic, strong, readwrite) NSArray> *viewModels; + +@property (nonatomic, strong) id object; +@property (nonatomic, assign) IGListDiffingSectionState state; + +@end + +@implementation IGListBindingSectionController + +#pragma mark - Public API + +- (void)updateAnimated:(BOOL)animated completion:(void (^)(BOOL))completion { + IGAssertMainThread(); + + if (self.state != IGListDiffingSectionStateIdle) { + if (completion != nil) { + completion(NO); + } + return; + } + self.state = IGListDiffingSectionStateUpdateQueued; + + __block IGListIndexSetResult *result = nil; + __block NSArray> *oldViewModels = nil; + + id collectionContext = self.collectionContext; + [self.collectionContext performBatchAnimated:animated updates:^(id batchContext) { + if (self.state != IGListDiffingSectionStateUpdateQueued) { + return; + } + + oldViewModels = self.viewModels; + + id object = self.object; + IGAssert(object != nil, @"Expected IGListBindingSectionController object to be non-nil before updating."); + + NSArray *newViewModels = [self.dataSource sectionController:self viewModelsForObject:object]; + self.viewModels = objectsWithDuplicateIdentifiersRemoved(newViewModels); + result = IGListDiff(oldViewModels, self.viewModels, IGListDiffEquality); + + [result.updates enumerateIndexesUsingBlock:^(NSUInteger oldUpdatedIndex, BOOL *stop) { + id identifier = [oldViewModels[oldUpdatedIndex] diffIdentifier]; + const NSInteger indexAfterUpdate = [result newIndexForIdentifier:identifier]; + if (indexAfterUpdate != NSNotFound) { + UICollectionViewCell *cell = [collectionContext cellForItemAtIndex:oldUpdatedIndex + sectionController:self]; + [cell bindViewModel:self.viewModels[indexAfterUpdate]]; + } + }]; + + if (IGListExperimentEnabled(self.collectionContext.experiments, IGListExperimentInvalidateLayoutForUpdates)) { + [batchContext invalidateLayoutInSectionController:self atIndexes:result.updates]; + } + [batchContext deleteInSectionController:self atIndexes:result.deletes]; + [batchContext insertInSectionController:self atIndexes:result.inserts]; + + for (IGListMoveIndex *move in result.moves) { + [batchContext moveInSectionController:self fromIndex:move.from toIndex:move.to]; + } + + self.state = IGListDiffingSectionStateUpdateApplied; + } completion:^(BOOL finished) { + self.state = IGListDiffingSectionStateIdle; + if (completion != nil) { + completion(YES); + } + }]; +} + +#pragma mark - IGListSectionController Overrides + +- (NSInteger)numberOfItems { + return self.viewModels.count; +} + +- (CGSize)sizeForItemAtIndex:(NSInteger)index { + return [self.dataSource sectionController:self sizeForViewModel:self.viewModels[index] atIndex:index]; +} + +- (UICollectionViewCell *)cellForItemAtIndex:(NSInteger)index { + id viewModel = self.viewModels[index]; + UICollectionViewCell *cell = [self.dataSource sectionController:self cellForViewModel:viewModel atIndex:index]; + [cell bindViewModel:viewModel]; + return cell; +} + +- (void)didUpdateToObject:(id)object { + id oldObject = self.object; + self.object = object; + + if (oldObject == nil) { + NSArray *viewModels = [self.dataSource sectionController:self viewModelsForObject:object]; + self.viewModels = objectsWithDuplicateIdentifiersRemoved(viewModels); + } else { +#if IGLK_LOGGING_ENABLED + if (![oldObject isEqualToDiffableObject:object]) { + IGLKLog(@"Warning: Unequal objects %@ and %@ will cause IGListBindingSectionController to reload the entire section", + oldObject, object); + } +#endif + [self updateAnimated:YES completion:nil]; + } +} + +- (void)moveObjectFromIndex:(NSInteger)sourceIndex toIndex:(NSInteger)destinationIndex { + NSMutableArray *viewModels = [self.viewModels mutableCopy]; + + id modelAtSource = [viewModels objectAtIndex:sourceIndex]; + [viewModels removeObjectAtIndex:sourceIndex]; + [viewModels insertObject:modelAtSource atIndex:destinationIndex]; + + self.viewModels = viewModels; +} + +- (void)didSelectItemAtIndex:(NSInteger)index { + [self.selectionDelegate sectionController:self didSelectItemAtIndex:index viewModel:self.viewModels[index]]; +} + +- (void)didDeselectItemAtIndex:(NSInteger)index { + [self.selectionDelegate sectionController:self didDeselectItemAtIndex:index viewModel:self.viewModels[index]]; +} + +- (void)didHighlightItemAtIndex:(NSInteger)index { + [self.selectionDelegate sectionController:self didHighlightItemAtIndex:index viewModel:self.viewModels[index]]; +} + +- (void)didUnhighlightItemAtIndex:(NSInteger)index { + [self.selectionDelegate sectionController:self didUnhighlightItemAtIndex:index viewModel:self.viewModels[index]]; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionControllerDataSource.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionControllerDataSource.h new file mode 100644 index 0000000..dcab7b8 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionControllerDataSource.h @@ -0,0 +1,65 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListBindingSectionController; + +@protocol IGListBindable; +@protocol IGListDiffable; + +NS_ASSUME_NONNULL_BEGIN + +/** + A protocol that returns data to power cells in an `IGListBindingSectionController`. + */ +NS_SWIFT_NAME(ListBindingSectionControllerDataSource) +@protocol IGListBindingSectionControllerDataSource + +/** + Create an array of view models given a top-level object. + + @param sectionController The section controller requesting view models. + @param object The top-level object that powers the section controller. + + @return A new array of view models. + */ +- (NSArray> *)sectionController:(IGListBindingSectionController *)sectionController + viewModelsForObject:(id)object; + +/** + Return a dequeued cell for a given view model. + + @param sectionController The section controller requesting a cell. + @param viewModel The view model for the cell. + @param index The index of the view model. + + @return A dequeued cell. + + @note The section controller will call `-bindViewModel:` with the provided view model after the cell is dequeued. You + should handle cell configuration using this method. However, you can do additional configuration at this stage as well. + */ +- (UICollectionViewCell *)sectionController:(IGListBindingSectionController *)sectionController + cellForViewModel:(id)viewModel + atIndex:(NSInteger)index; + +/** + Return a cell size for a given view model. + + @param sectionController The section controller requesting a size. + @param viewModel The view model for the cell. + @param index The index of the view model. + + @return A size for the view model. + */ +- (CGSize)sectionController:(IGListBindingSectionController *)sectionController + sizeForViewModel:(id)viewModel + atIndex:(NSInteger)index; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionControllerSelectionDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionControllerSelectionDelegate.h new file mode 100644 index 0000000..f12b7ce --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListBindingSectionControllerSelectionDelegate.h @@ -0,0 +1,66 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListBindingSectionController; + +NS_ASSUME_NONNULL_BEGIN + +/** + A protocol that handles cell selection events in an `IGListBindingSectionController`. + */ +NS_SWIFT_NAME(ListBindingSectionControllerSelectionDelegate) +@protocol IGListBindingSectionControllerSelectionDelegate + +/** + Tells the delegate that a cell at a given index was selected. + + @param sectionController The section controller the selection occurred in. + @param index The index of the selected cell. + @param viewModel The view model that was bound to the cell. + */ +- (void)sectionController:(IGListBindingSectionController *)sectionController + didSelectItemAtIndex:(NSInteger)index + viewModel:(id)viewModel; + +/** + Tells the delegate that a cell at a given index was deselected. + + @param sectionController The section controller the deselection occurred in. + @param index The index of the deselected cell. + @param viewModel The view model that was bound to the cell. + */ +- (void)sectionController:(IGListBindingSectionController *)sectionController + didDeselectItemAtIndex:(NSInteger)index + viewModel:(id)viewModel; + +/** + Tells the delegate that a cell at a given index was highlighted. + + @param sectionController The section controller the highlight occurred in. + @param index The index of the highlighted cell. + @param viewModel The view model that was bound to the cell. + */ +- (void)sectionController:(IGListBindingSectionController *)sectionController + didHighlightItemAtIndex:(NSInteger)index + viewModel:(id)viewModel; + +/** + Tells the delegate that a cell at a given index was unhighlighted. + + @param sectionController The section controller the unhighlight occurred in. + @param index The index of the unhighlighted cell. + @param viewModel The view model that was bound to the cell. + */ +- (void)sectionController:(IGListBindingSectionController *)sectionController +didUnhighlightItemAtIndex:(NSInteger)index + viewModel:(id)viewModel; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionContext.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionContext.h new file mode 100644 index 0000000..6dfee68 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionContext.h @@ -0,0 +1,305 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import +#import + +NS_ASSUME_NONNULL_BEGIN + +@class IGListSectionController; + +/** + The collection context provides limited access to the collection-related information that + section controllers need for operations like sizing, dequeuing cells, inserting, deleting, reloading, etc. + */ +NS_SWIFT_NAME(ListCollectionContext) +@protocol IGListCollectionContext + +/** + The size of the collection view. You can use this for sizing cells. + */ +@property (nonatomic, readonly) CGSize containerSize; + +/** + The content insets of the collection view. You can use this for sizing cells. + */ +@property (nonatomic, readonly) UIEdgeInsets containerInset; + +/** + The adjusted content insets of the collection view. Equivalent to containerInset under iOS 11. + */ +@property (nonatomic, readonly) UIEdgeInsets adjustedContainerInset; + +/** + The size of the collection view with content insets applied. + */ +@property (nonatomic, readonly) CGSize insetContainerSize; + +/** + The current scrolling traits of the underlying collection view. + */ +@property (nonatomic, readonly) IGListCollectionScrollingTraits scrollingTraits; + +/** + A bitmask of experiments to conduct on the section controller. + */ +@property (nonatomic, assign) IGListExperiment experiments; + +/** + Returns size of the collection view relative to the section controller. + + @param sectionController The section controller requesting this information. + + @return The size of the collection view minus the given section controller's insets. + */ +- (CGSize)containerSizeForSectionController:(IGListSectionController *)sectionController; + +/** + Returns the index of the specified cell in the collection relative to the section controller. + + @param cell An existing cell in the collection. + @param sectionController The section controller requesting this information. + + @return The index of the cell or `NSNotFound` if it does not exist in the collection. + */ +- (NSInteger)indexForCell:(UICollectionViewCell *)cell + sectionController:(IGListSectionController *)sectionController; + +/** + Returns the cell in the collection at the specified index for the section controller. + + @param index The index of the desired cell. + @param sectionController The section controller requesting this information. + + @return The collection view cell, or `nil` if not found. + + @warning This method may return `nil` if the cell is offscreen. + */ +- (nullable __kindof UICollectionViewCell *)cellForItemAtIndex:(NSInteger)index + sectionController:(IGListSectionController *)sectionController; + +/** + Returns the visible cells for the given section controller. + + @param sectionController The section controller requesting this information. + + @return An array of visible cells, or an empty array if none are found. + */ +- (NSArray *)visibleCellsForSectionController:(IGListSectionController *)sectionController; + +/** + Returns the visible paths for the given section controller. + + @param sectionController The section controller requesting this information. + + @return An array of visible index paths, or an empty array if none are found. + */ +- (NSArray *)visibleIndexPathsForSectionController:(IGListSectionController *) sectionController; + +/** + Deselects a cell in the collection. + + @param index The index of the item to deselect. + @param sectionController The section controller requesting this information. + @param animated Pass `YES` to animate the change, `NO` otherwise. + */ +- (void)deselectItemAtIndex:(NSInteger)index + sectionController:(IGListSectionController *)sectionController + animated:(BOOL)animated; + +/** + Selects a cell in the collection. + + @param index The index of the item to select. + @param sectionController The section controller requesting this information. + @param animated Pass `YES` to animate the change, `NO` otherwise. + @param scrollPosition An option that specifies where the item should be positioned when scrolling finishes. + */ +- (void)selectItemAtIndex:(NSInteger)index + sectionController:(IGListSectionController *)sectionController + animated:(BOOL)animated + scrollPosition:(UICollectionViewScrollPosition)scrollPosition; + +/** + Dequeues a cell from the collection view reuse pool. + + @param cellClass The class of the cell you want to dequeue. + @param reuseIdentifier A reuse identifier for the specified cell. This parameter may be `nil`. + @param sectionController The section controller requesting this information. + @param index The index of the cell. + + @return A cell dequeued from the reuse pool or a newly created one. + + @note This method uses a string representation of the cell class as the identifier. + */ +- (__kindof UICollectionViewCell *)dequeueReusableCellOfClass:(Class)cellClass + withReuseIdentifier:(nullable NSString *)reuseIdentifier + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index; + +/** + Dequeues a cell from the collection view reuse pool. + + @param cellClass The class of the cell you want to dequeue. + @param sectionController The section controller requesting this information. + @param index The index of the cell. + + @return A cell dequeued from the reuse pool or a newly created one. + + @note This method uses a string representation of the cell class as the identifier. + */ +- (__kindof UICollectionViewCell *)dequeueReusableCellOfClass:(Class)cellClass + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index; + +/** + Dequeues a cell from the collection view reuse pool. + + @param nibName The name of the nib file. + @param bundle The bundle in which to search for the nib file. If `nil`, this method searches the main bundle. + @param sectionController The section controller requesting this information. + @param index The index of the cell. + + @return A cell dequeued from the reuse pool or a newly created one. + + @note This method uses a string representation of the cell class as the identifier. + */ +- (__kindof UICollectionViewCell *)dequeueReusableCellWithNibName:(NSString *)nibName + bundle:(nullable NSBundle *)bundle + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index; + +/** + Dequeues a storyboard prototype cell from the collection view reuse pool. + + @param identifier The identifier of the cell prototype in storyboard. + @param sectionController The section controller requesting this information. + @param index The index of the cell. + + @return A cell dequeued from the reuse pool or a newly created one. + */ +- (__kindof UICollectionViewCell *)dequeueReusableCellFromStoryboardWithIdentifier:(NSString *)identifier + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index; + +/** + Dequeues a supplementary view from the collection view reuse pool. + + @param elementKind The kind of supplementary view. + @param sectionController The section controller requesting this information. + @param viewClass The class of the supplementary view. + @param index The index of the supplementary view. + + @return A supplementary view dequeued from the reuse pool or a newly created one. + + @note This method uses a string representation of the view class as the identifier. + */ +- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewOfKind:(NSString *)elementKind + forSectionController:(IGListSectionController *)sectionController + class:(Class)viewClass + atIndex:(NSInteger)index; + +/** + Dequeues a supplementary view from the collection view reuse pool. + + @param elementKind The kind of supplementary view. + @param identifier The identifier of the supplementary view in storyboard. + @param sectionController The section controller requesting this information. + @param index The index of the supplementary view. + + @return A supplementary view dequeued from the reuse pool or a newly created one. + */ +- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewFromStoryboardOfKind:(NSString *)elementKind + withIdentifier:(NSString *)identifier + forSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index; +/** + Dequeues a supplementary view from the collection view reuse pool. + + @param elementKind The kind of supplementary view. + @param sectionController The section controller requesting this information. + @param nibName The name of the nib file. + @param bundle The bundle in which to search for the nib file. If `nil`, this method searches the main bundle. + @param index The index of the supplementary view. + + @return A supplementary view dequeued from the reuse pool or a newly created one. + + @note This method uses a string representation of the view class as the identifier. + */ +- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewOfKind:(NSString *)elementKind + forSectionController:(IGListSectionController *)sectionController + nibName:(NSString *)nibName + bundle:(nullable NSBundle *)bundle + atIndex:(NSInteger)index; + +/** + Invalidate the backing `UICollectionViewLayout` for all items in the section controller. + + @param sectionController The section controller that needs invalidating. + @param completion An optional completion block to execute when the updates are finished. + + @note This method can be wrapped in `UIView` animation APIs to control the duration or perform without animations. This + will end up calling `-[UICollectionView performBatchUpdates:completion:]` internally, so invalidated changes may not be + reflected in the cells immediately. + */ +- (void)invalidateLayoutForSectionController:(IGListSectionController *)sectionController + completion:(nullable void (^)(BOOL finished))completion; + +/** + Batches and performs many cell-level updates in a single transaction. + + @param animated A flag indicating if the transition should be animated. + @param updates A block with a context parameter to make mutations. + @param completion An optional completion block to execute when the updates are finished. + + @note You should make state changes that impact the number of items in your section controller within the updates + block alongside changes on the context object. + + For example, inside your section controllers, you may want to delete *and* insert into the data source that backs your + section controller. For example: + + ``` + [self.collectionContext performBatchItemUpdates:^ (id batchContext>){ + // perform data source changes inside the update block + [self.items addObject:newItem]; + [self.items removeObjectAtIndex:0]; + + NSIndexSet *inserts = [NSIndexSet indexSetWithIndex:[self.items count] - 1]; + [batchContext insertInSectionController:self atIndexes:inserts]; + + NSIndexSet *deletes = [NSIndexSet indexSetWithIndex:0]; + [batchContext deleteInSectionController:self atIndexes:deletes]; + } completion:nil]; + ``` + + @warning You **must** perform data modifications **inside** the update block. Updates will not be performed + synchronously, so you should make sure that your data source changes only when necessary. + */ +- (void)performBatchAnimated:(BOOL)animated + updates:(void (^)(id batchContext))updates + completion:(nullable void (^)(BOOL finished))completion; + + +/** + Scrolls to the specified section controller in the list. + + @param sectionController The section controller. + @param index The index of the item in the section controller to which to scroll. + @param scrollPosition An option that specifies where the item should be positioned when scrolling finishes. + @param animated A flag indicating if the scrolling should be animated. + */ +- (void)scrollToSectionController:(IGListSectionController *)sectionController + atIndex:(NSInteger)index + scrollPosition:(UICollectionViewScrollPosition)scrollPosition + animated:(BOOL)animated; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionScrollingTraits.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionScrollingTraits.h new file mode 100644 index 0000000..d93a30f --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionScrollingTraits.h @@ -0,0 +1,22 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +/** + The current scrolling traits of the underlying collection view. + The attributes are always equal to their corresponding properties on the underlying collection view. + */ +NS_SWIFT_NAME(ListCollectionScrollingTraits) +typedef struct IGListCollectionScrollingTraits { + /// returns YES if user has touched. may not yet have started dragging. + bool isTracking; + /// returns YES if user has started scrolling. this may require some time and or distance to move to initiate dragging + bool isDragging; + /// returns YES if user isn't dragging (touch up) but scroll view is still moving. + bool isDecelerating; +} IGListCollectionScrollingTraits; diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionView.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionView.h new file mode 100644 index 0000000..b7e880b --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionView.h @@ -0,0 +1,49 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@protocol IGListCollectionViewLayoutCompatible; + +NS_ASSUME_NONNULL_BEGIN + +/** + This `UICollectionView` subclass allows for partial layout invalidation using `IGListCollectionViewLayout`, + or custom layout classes that conform to IGListCollectionViewLayoutCompatible. + + @note When updating a collection view (ex: calling `-insertSections`), `-invalidateLayoutWithContext` gets called on + the layout object. However, the invalidation context doesn't provide details on which index paths are being modified, + which typically forces a full layout re-calculation. `IGListCollectionView` gives `IGListCollectionViewLayout` the + missing information to re-calculate only the modified layout attributes. + */ +NS_SWIFT_NAME(ListCollectionView) +@interface IGListCollectionView : UICollectionView + +/** + Create a new view with an `IGListcollectionViewLayout` class or subclass. + + @param frame The frame to initialize with. + @param collectionViewLayout The layout to use with the collection view. You can use IGListCollectionViewLayout + here, or a custom layout class that conforms to IGListCollectionViewLayoutCompatible. + + @note You can initialize a new view with a base layout by simply calling `-[IGListCollectionView initWithFrame:]`. + */ +- (instancetype)initWithFrame:(CGRect)frame listCollectionViewLayout:(UICollectionViewLayout *)collectionViewLayout NS_DESIGNATED_INITIALIZER; + +/** + :nodoc: + */ +- (instancetype)initWithFrame:(CGRect)frame collectionViewLayout:(UICollectionViewLayout *)collectionViewLayout NS_UNAVAILABLE; + +/** + :nodoc: + */ +- (instancetype)initWithCoder:(NSCoder *)aDecoder NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionView.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionView.m new file mode 100644 index 0000000..e54e02a --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionView.m @@ -0,0 +1,105 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListCollectionView.h" + +#import "IGListCollectionViewLayout.h" +#import "IGListCollectionViewLayoutCompatible.h" + +@implementation IGListCollectionView + +#pragma mark - Init + +- (instancetype)initWithFrame:(CGRect)frame { + IGListCollectionViewLayout *layout = [[IGListCollectionViewLayout alloc] initWithStickyHeaders:NO topContentInset:0 stretchToEdge:YES]; + return [self initWithFrame:frame listCollectionViewLayout:layout]; +} + +- (instancetype)initWithFrame:(CGRect)frame listCollectionViewLayout:(UICollectionViewLayout *)collectionViewLayout { + return [super initWithFrame:frame collectionViewLayout:collectionViewLayout]; +} + +#pragma mark - IGListCollectionViewLayout + +- (UICollectionViewLayout *)_listLayout { + if ([self.collectionViewLayout conformsToProtocol:@protocol(IGListCollectionViewLayoutCompatible)]) { + return (UICollectionViewLayout *)self.collectionViewLayout; + } + + return nil; +} + +#pragma mark - Overides reloads + +- (void)reloadItemsAtIndexPaths:(NSArray *)indexPaths { + [self _didModifyIndexPaths:indexPaths]; + [super reloadItemsAtIndexPaths:indexPaths]; +} + +- (void)reloadSections:(NSIndexSet *)sections { + [self _didModifySections:sections]; + [super reloadSections:sections]; +} + +#pragma mark - Override deletes + +- (void)deleteItemsAtIndexPaths:(NSArray *)indexPaths { + [self _didModifyIndexPaths:indexPaths]; + [super deleteItemsAtIndexPaths:indexPaths]; +} + +- (void)deleteSections:(NSIndexSet *)sections { + [self _didModifySections:sections]; + [super deleteSections:sections]; +} + +#pragma mark - Override inserts + +- (void)insertItemsAtIndexPaths:(NSArray *)indexPaths { + [self _didModifyIndexPaths:indexPaths]; + [super insertItemsAtIndexPaths:indexPaths]; +} + +- (void)insertSections:(NSIndexSet *)sections { + [self _didModifySections:sections]; + [super insertSections:sections]; +} + +#pragma mark - Override moves + +- (void)moveItemAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath { + [self _didModifyIndexPaths:@[indexPath, newIndexPath]]; + [super moveItemAtIndexPath:indexPath toIndexPath:newIndexPath]; +} + +- (void)moveSection:(NSInteger)section toSection:(NSInteger)newSection { + [self _didModifySection:MIN(section, newSection)]; + [super moveSection:section toSection:newSection]; +} + +#pragma mark - Modify section + +- (void)_didModifySections:(NSIndexSet *)sections { + if (sections.count == 0) { + return; + } + [self _didModifySection:sections.firstIndex]; +} + +- (void)_didModifySection:(NSUInteger)section { + [self._listLayout didModifySection:section]; +} + +#pragma mark - Modified index path + +- (void)_didModifyIndexPaths:(NSArray *)indexPaths { + for (NSIndexPath *indexPath in indexPaths) { + [self _didModifySection:indexPath.section]; + } +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewDelegateLayout.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewDelegateLayout.h new file mode 100644 index 0000000..6c360d9 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewDelegateLayout.h @@ -0,0 +1,36 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +/** + Conform to `IGListCollectionViewDelegateLayout` to provide customized layout information for a collection view. + */ +@protocol IGListCollectionViewDelegateLayout + +/** + Asks the delegate to customize and return the starting layout information for an item being inserted into the collection view. + + @param collectionView The collection view to perform the transition on. + @param collectionViewLayout The layout to use with the collection view. + @param attributes The starting layout information for an item being inserted into the collection view. + @param indexPath The index path of the item being inserted. + */ +- (UICollectionViewLayoutAttributes *)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout customizedInitialLayoutAttributes:(UICollectionViewLayoutAttributes *)attributes atIndexPath:(NSIndexPath *)indexPath; + +/** + Asks the delegate to customize and return the final layout information for an item that is about to be removed from the collection view. + + @param collectionView The collection view to perform the transition on. + @param collectionViewLayout The layout to use with the collection view. + @param attributes The final layout information for an item that is about to be removed from the collection view. + @param indexPath The index path of the item being deleted. + */ +- (UICollectionViewLayoutAttributes *)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout customizedFinalLayoutAttributes:(UICollectionViewLayoutAttributes *)attributes atIndexPath:(NSIndexPath *)indexPath; + +@end + diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayout.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayout.h new file mode 100644 index 0000000..71cfbd7 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayout.h @@ -0,0 +1,142 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import + +#import "IGListCollectionViewLayoutCompatible.h" + +NS_ASSUME_NONNULL_BEGIN + +/** + This UICollectionViewLayout subclass is for vertically or horizontally scrolling lists of data with variable widths and + heights. It supports an infinite number of sections and items. All work is done on the main thread, and while extremely efficient, + care must be taken not to stall the main thread in sizing delegate methods. + + This layout piggybacks on the mechanics of UICollectionViewFlowLayout in that: + + - Your UICollectionView data source must also conform to UICollectionViewDelegateFlowLayout + - Header support given via UICollectionElementKindSectionHeader + + All UICollectionViewDelegateFlowLayout methods are required and used by this layout: + + ``` + - (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath; + - (UIEdgeInsets)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout insetForSectionAtIndex:(NSInteger)section; + - (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout minimumLineSpacingForSectionAtIndex:(NSInteger)section; + - (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout minimumInteritemSpacingForSectionAtIndex:(NSInteger)section; + - (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout referenceSizeForHeaderInSection:(NSInteger)section; + ``` + + In a vertically scrolling layout, sections and items are put into the same horizontal row until the max-x position + of an item extends beyond the width of the collection view. When that happens, the item is "newlined" to the next row. + The y position of that row is determined by the maximum height (including section insets) of the section/item of the previous row. + + Ex. of a section (2,0) with a large width causing a newline. + ``` + |[ 0,0 ][ 1,0 ] | + |[ 2,0 ]| + ``` + + A section with a non-zero height header will always cause that section to newline. Headers are always stretched to the + width of the collection view, pinched with the section insets. + + Ex. of a section (2,0) with a header inset on the left/right. + ``` + |[ 0,0 ][ 1,0 ] | + | >======header=======< | + | [ 2,0 ] | + ``` + + Section insets apply to items in the section no matter if they begin on a new row or are on the same row as a previous + section. + + Ex. of a section (2) with multiple items and a left inset. + ``` + |[ 0,0 ][ 1,0 ] >[ 2,0 ]| + | >[ 2,1 ][ 2,2 ][ 2,3 ]| + ``` + + Interitem spacing applies to items and sections within the same row. Line spacing only applies to items within the same + section. + + In a horizontally scrolling layout, sections and items are flowed vertically until they need to be "newlined" to the + next column. Headers, if used, are stretched to the height of the collection view, minus the section insets. + + Please see the unit tests for more configuration examples and expected output. + */ +NS_SWIFT_NAME(ListCollectionViewLayout) +@interface IGListCollectionViewLayout : UICollectionViewLayout + +/** + Direction in which layout will be scrollable; items will be flowed in the perpendicular direction, "newlining" when they + run out of space along that axis or when a non-zero header is found. + */ +@property (nonatomic, readonly) UICollectionViewScrollDirection scrollDirection; + +/** + Set this to adjust the offset of the sticky headers in the scrolling direction. Can be used to change the sticky + header position as UI like the navigation bar is scrolled offscreen. In a vertically scrolling layout, changing + this to the height of the navigation bar will give the effect of the headers sticking to the nav as it is collapsed. + + @note Changing the value on this method will invalidate the layout every time. + */ +@property (nonatomic, assign) CGFloat stickyHeaderYOffset; + +/** + Set this to `YES` to show sticky header when a section had no item. Default is `NO`. +*/ +@property (nonatomic, assign) BOOL showHeaderWhenEmpty; + +/** + A bitmask of experiments to conduct on the adapter. + */ +@property (nonatomic, assign) IGListExperiment experiments; + +/** + Create and return a new collection view layout. + + @param stickyHeaders Set to `YES` to stick section headers to the top of the bounds while scrolling. + @param scrollDirection Direction along which the collection view will be scrollable (if content size exceeds the frame size) + @param topContentInset The content inset (top or left, depending on scrolling direction) used to offset the sticky headers. Ignored if stickyHeaders is `NO`. + @param stretchToEdge Specifies whether to stretch width (in vertically scrolling layout) or height (horizontally scrolling) of last item to right/bottom edge when distance from last item to right/bottom edge < epsilon(1) + + @return A new collection view layout. + */ +- (instancetype)initWithStickyHeaders:(BOOL)stickyHeaders + scrollDirection:(UICollectionViewScrollDirection)scrollDirection + topContentInset:(CGFloat)topContentInset + stretchToEdge:(BOOL)stretchToEdge NS_DESIGNATED_INITIALIZER; + +/** + Create and return a new vertically scrolling collection view layout. + + @param stickyHeaders Set to `YES` to stick section headers to the top of the bounds while scrolling. + @param topContentInset The top content inset used to offset the sticky headers. Ignored if stickyHeaders is `NO`. + @param stretchToEdge Specifies whether to stretch width of last item to right edge when distance from last item to right edge < epsilon(1) + + @return A new collection view layout. + */ +- (instancetype)initWithStickyHeaders:(BOOL)stickyHeaders + topContentInset:(CGFloat)topContentInset + stretchToEdge:(BOOL)stretchToEdge; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayout.mm b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayout.mm new file mode 100644 index 0000000..46869c8 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayout.mm @@ -0,0 +1,681 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListCollectionViewLayout.h" +#import "IGListCollectionViewLayoutInternal.h" + +#import + +#import +#import + +#import "UIScrollView+IGListKit.h" + +static CGFloat UIEdgeInsetsLeadingInsetInDirection(UIEdgeInsets insets, UICollectionViewScrollDirection direction) { + switch (direction) { + case UICollectionViewScrollDirectionVertical: return insets.top; + case UICollectionViewScrollDirectionHorizontal: return insets.left; + } +} + +static CGFloat UIEdgeInsetsTrailingInsetInDirection(UIEdgeInsets insets, UICollectionViewScrollDirection direction) { + switch (direction) { + case UICollectionViewScrollDirectionVertical: return insets.bottom; + case UICollectionViewScrollDirectionHorizontal: return insets.right; + } +} + +static CGFloat CGPointGetCoordinateInDirection(CGPoint point, UICollectionViewScrollDirection direction) { + switch (direction) { + case UICollectionViewScrollDirectionVertical: return point.y; + case UICollectionViewScrollDirectionHorizontal: return point.x; + } +} + +static CGFloat CGRectGetLengthInDirection(CGRect rect, UICollectionViewScrollDirection direction) { + switch (direction) { + case UICollectionViewScrollDirectionVertical: return rect.size.height; + case UICollectionViewScrollDirectionHorizontal: return rect.size.width; + } +} + +static CGFloat CGRectGetMaxInDirection(CGRect rect, UICollectionViewScrollDirection direction) { + switch (direction) { + case UICollectionViewScrollDirectionVertical: return CGRectGetMaxY(rect); + case UICollectionViewScrollDirectionHorizontal: return CGRectGetMaxX(rect); + } +} + +static CGFloat CGRectGetMinInDirection(CGRect rect, UICollectionViewScrollDirection direction) { + switch (direction) { + case UICollectionViewScrollDirectionVertical: return CGRectGetMinY(rect); + case UICollectionViewScrollDirectionHorizontal: return CGRectGetMinX(rect); + } +} + +static CGFloat CGSizeGetLengthInDirection(CGSize size, UICollectionViewScrollDirection direction) { + switch (direction) { + case UICollectionViewScrollDirectionVertical: return size.height; + case UICollectionViewScrollDirectionHorizontal: return size.width; + } +} + +static NSIndexPath *indexPathForSection(NSInteger section) { + return [NSIndexPath indexPathForItem:0 inSection:section]; +} + +static NSInteger IGListMergeMinimumInvalidatedSection(NSInteger section, NSInteger otherSection) { + if (section == NSNotFound && otherSection == NSNotFound) { + return NSNotFound; + } else if (section == NSNotFound) { + return otherSection; + } else if (otherSection == NSNotFound) { + return section; + } + + return MIN(section, otherSection); +} + +struct IGListSectionEntry { + /** + Represents the minimum-bounding box of every element in the section. This includes all item frames as well as the + header bounds. It is made simply by unioning all item and header frames. Use this to find section intersections + to build layout attributes given a rect. + */ + CGRect bounds; + + // The insets for the section. Used to find total content size of the section. + UIEdgeInsets insets; + + // The RESTING frame of the header view (e.g. when the header is not sticking to the top of the scroll view). + CGRect headerBounds; + + // The RESTING frame of the footer view + CGRect footerBounds; + + // An array of frames for each cell in the section. + std::vector itemBounds; + + // last item distance in scroll direction, used for partial invalidation + CGFloat lastItemCoordInScrollDirection; + + // last item distance in fixed direction, used for partial invalidation + CGFloat lastItemCoordInFixedDirection; + + // last next row distance in scroll direction, used for partial invalidation + CGFloat lastNextRowCoordInScrollDirection; + + // Returns YES when the section has visible content (header and/or items). + BOOL isValid() { + return !CGSizeEqualToSize(bounds.size, CGSizeZero); + } +}; + +// Each section has a base zIndex of section * maxZIndexPerSection; +// section header adds (maxZIndexPerSection - 1) to the base zIndex; +// other cells adds (item) to the base zIndex. +// This allows us to present tooltips that can grow from the cell to its top. +static void adjustZIndexForAttributes(UICollectionViewLayoutAttributes *attributes) { + const NSInteger maxZIndexPerSection = 1000; + const NSInteger baseZIndex = attributes.indexPath.section * maxZIndexPerSection; + + switch (attributes.representedElementCategory) { + case UICollectionElementCategoryCell: + attributes.zIndex = baseZIndex + attributes.indexPath.item; + break; + case UICollectionElementCategorySupplementaryView: + attributes.zIndex = baseZIndex + maxZIndexPerSection - 1; + break; + case UICollectionElementCategoryDecorationView: + attributes.zIndex = baseZIndex - 1; + break; + } +} + +@interface IGListCollectionViewLayoutInvalidationContext : UICollectionViewLayoutInvalidationContext +@property (nonatomic, assign) BOOL ig_invalidateSupplementaryAttributes; +@property (nonatomic, assign) BOOL ig_invalidateAllAttributes; +@end + +@implementation IGListCollectionViewLayoutInvalidationContext +@end + +@interface IGListCollectionViewLayout () + +@property (nonatomic, assign, readonly) BOOL stickyHeaders; +@property (nonatomic, assign, readonly) CGFloat topContentInset; +@property (nonatomic, assign, readonly) BOOL stretchToEdge; + +@end + +@implementation IGListCollectionViewLayout { + std::vector _sectionData; + NSMutableDictionary *_attributesCache; + + // invalidate starting at this section + NSInteger _minimumInvalidatedSection; + + /** + The workflow for getting sticky headers working: + 1. Use a custom invalidation context to mark supplementary attributes invalid. + 2. Return YES from -shouldInvalidateLayoutForBoundsChange: + 3. In -invalidationContextForBoundsChange: mark supplementary attributes invalid on the custom context. + 4. Purge supplementary caches in -invalidateLayoutWithContext: if context says they are invalid + 5. Use cached attributes in -layoutAttributesForSupplementaryViewOfKind:atIndexPath: if they exist, else rebuild + 6. Make sure -layoutAttributesForElementsInRect: always uses the attributes returned from + -layoutAttributesForSupplementaryViewOfKind:atIndexPath:. + */ + NSMutableDictionary *> *_supplementaryAttributesCache; +} + +- (instancetype)initWithStickyHeaders:(BOOL)stickyHeaders + topContentInset:(CGFloat)topContentInset + stretchToEdge:(BOOL)stretchToEdge { + return [self initWithStickyHeaders:stickyHeaders + scrollDirection:UICollectionViewScrollDirectionVertical + topContentInset:topContentInset + stretchToEdge:stretchToEdge]; +} + +- (instancetype)initWithStickyHeaders:(BOOL)stickyHeaders + scrollDirection:(UICollectionViewScrollDirection)scrollDirection + topContentInset:(CGFloat)topContentInset + stretchToEdge:(BOOL)stretchToEdge { + if (self = [super init]) { + _scrollDirection = scrollDirection; + _stickyHeaders = stickyHeaders; + _topContentInset = topContentInset; + _stretchToEdge = stretchToEdge; + _attributesCache = [NSMutableDictionary new]; + _supplementaryAttributesCache = [NSMutableDictionary dictionaryWithDictionary:@{ + UICollectionElementKindSectionHeader: [NSMutableDictionary new], + UICollectionElementKindSectionFooter: [NSMutableDictionary new], + }]; + _minimumInvalidatedSection = NSNotFound; + } + return self; +} + +- (instancetype)initWithCoder:(NSCoder *)aDecoder { + return [self initWithStickyHeaders:NO topContentInset:0 stretchToEdge:NO]; +} + +#pragma mark - UICollectionViewLayout + +- (UICollectionViewLayoutAttributes *)initialLayoutAttributesForAppearingItemAtIndexPath:(NSIndexPath *)itemIndexPath { + UICollectionViewLayoutAttributes *attributes = [super initialLayoutAttributesForAppearingItemAtIndexPath:itemIndexPath]; + id delegate = (id)self.collectionView.delegate; + if ([delegate respondsToSelector:@selector(collectionView:layout:customizedInitialLayoutAttributes:atIndexPath:)]) { + return [delegate collectionView:self.collectionView + layout:self + customizedInitialLayoutAttributes:attributes + atIndexPath:itemIndexPath]; + } + return attributes; +} + +- (UICollectionViewLayoutAttributes *)finalLayoutAttributesForDisappearingItemAtIndexPath:(NSIndexPath *)itemIndexPath{ + UICollectionViewLayoutAttributes *attributes = [super finalLayoutAttributesForDisappearingItemAtIndexPath:itemIndexPath]; + id delegate = (id)self.collectionView.delegate; + if ([delegate respondsToSelector:@selector(collectionView:layout:customizedFinalLayoutAttributes:atIndexPath:)]) { + return [delegate collectionView:self.collectionView + layout:self + customizedFinalLayoutAttributes:attributes + atIndexPath:itemIndexPath]; + } + return attributes; +} + +- (NSArray *)layoutAttributesForElementsInRect:(CGRect)rect { + IGAssertMainThread(); + + NSMutableArray *result = [NSMutableArray new]; + + const NSRange range = [self _rangeOfSectionsInRect:rect]; + if (range.location == NSNotFound) { + return nil; + } + + for (NSInteger section = range.location; section < NSMaxRange(range); section++) { + const NSInteger itemCount = _sectionData[section].itemBounds.size(); + + // do not add headers if there are no items + if (itemCount > 0 || self.showHeaderWhenEmpty) { + for (NSString *elementKind in _supplementaryAttributesCache.allKeys) { + NSIndexPath *indexPath = indexPathForSection(section); + UICollectionViewLayoutAttributes *attributes = [self layoutAttributesForSupplementaryViewOfKind:elementKind + atIndexPath:indexPath]; + // do not add zero height headers/footers or headers/footers that are outside the rect + const CGRect frame = attributes.frame; + const CGRect intersection = CGRectIntersection(frame, rect); + if (attributes && !CGRectIsEmpty(intersection) && CGRectGetLengthInDirection(frame, self.scrollDirection) > 0.0) { + [result addObject:attributes]; + } + } + } + + // add all cells within the rect, return early if it starts iterating outside + for (NSInteger item = 0; item < itemCount; item++) { + NSIndexPath *indexPath = [NSIndexPath indexPathForItem:item inSection:section]; + UICollectionViewLayoutAttributes *attributes = [self layoutAttributesForItemAtIndexPath:indexPath]; + if (CGRectIntersectsRect(attributes.frame, rect)) { + [result addObject:attributes]; + } + } + } + + return result; +} + +- (UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath { + IGAssertMainThread(); + IGParameterAssert(indexPath != nil); + + UICollectionViewLayoutAttributes *attributes = _attributesCache[indexPath]; + if (attributes != nil) { + return attributes; + } + + // avoid OOB errors + const NSInteger section = indexPath.section; + const NSInteger item = indexPath.item; + if (section >= _sectionData.size() + || item >= _sectionData[section].itemBounds.size()) { + return nil; + } + + attributes = [[[self class] layoutAttributesClass] layoutAttributesForCellWithIndexPath:indexPath]; + attributes.frame = _sectionData[indexPath.section].itemBounds[indexPath.item]; + adjustZIndexForAttributes(attributes); + _attributesCache[indexPath] = attributes; + return attributes; +} + +- (UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryViewOfKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath { + IGAssertMainThread(); + IGParameterAssert(indexPath != nil); + + UICollectionViewLayoutAttributes *attributes = _supplementaryAttributesCache[elementKind][indexPath]; + if (attributes != nil) { + return attributes; + } + + // avoid OOB errors + const NSInteger section = indexPath.section; + if (section >= _sectionData.size()) { + return nil; + } + + UICollectionView *collectionView = self.collectionView; + const IGListSectionEntry entry = _sectionData[section]; + const CGFloat minOffset = CGRectGetMinInDirection(entry.bounds, self.scrollDirection); + + CGRect frame = CGRectZero; + + if ([elementKind isEqualToString:UICollectionElementKindSectionHeader]) { + frame = entry.headerBounds; + + if (self.stickyHeaders) { + CGFloat offset = CGPointGetCoordinateInDirection(collectionView.contentOffset, self.scrollDirection) + self.topContentInset + self.stickyHeaderYOffset; + + if (section + 1 == _sectionData.size()) { + offset = MAX(minOffset, offset); + } else { + const CGFloat maxOffset = CGRectGetMinInDirection(_sectionData[section + 1].bounds, self.scrollDirection) - CGRectGetLengthInDirection(frame, self.scrollDirection); + offset = MIN(MAX(minOffset, offset), maxOffset); + } + switch (self.scrollDirection) { + case UICollectionViewScrollDirectionVertical: + frame.origin.y = offset; + break; + case UICollectionViewScrollDirectionHorizontal: + frame.origin.x = offset; + break; + } + } + } else if ([elementKind isEqualToString:UICollectionElementKindSectionFooter]) { + frame = entry.footerBounds; + } + + if (CGRectIsEmpty(frame)) { + // Just like UICollectionViewFlowLayout, if the header/footer size is empty, do not not return an attribute. + // If we did return something, calling [UICollectionView layoutAttributesForSupplementaryElementOfKind...] would too, + // which could then crash if the UICollectionViewDelegate is not expecting to actually return a supplimentary view. + return nil; + } else { + attributes = [UICollectionViewLayoutAttributes layoutAttributesForSupplementaryViewOfKind:elementKind withIndexPath:indexPath]; + attributes.frame = frame; + adjustZIndexForAttributes(attributes); + _supplementaryAttributesCache[elementKind][indexPath] = attributes; + return attributes; + } +} + +- (CGSize)collectionViewContentSize { + IGAssertMainThread(); + + const NSInteger sectionCount = _sectionData.size(); + + if (sectionCount == 0) { + return CGSizeZero; + } + + const IGListSectionEntry section = _sectionData[sectionCount - 1]; + UICollectionView *collectionView = self.collectionView; + const UIEdgeInsets contentInset = collectionView.ig_contentInset; + switch (self.scrollDirection) { + case UICollectionViewScrollDirectionVertical: { + const CGFloat height = CGRectGetMaxY(section.bounds) + section.insets.bottom; + return CGSizeMake(CGRectGetWidth(collectionView.bounds) - contentInset.left - contentInset.right, height); + } + case UICollectionViewScrollDirectionHorizontal: { + const CGFloat width = CGRectGetMaxX(section.bounds) + section.insets.right; + return CGSizeMake(width, CGRectGetHeight(collectionView.bounds) - contentInset.top - contentInset.bottom); + } + } + +} + +- (void)invalidateLayoutWithContext:(IGListCollectionViewLayoutInvalidationContext *)context { + BOOL hasInvalidatedItemIndexPaths = NO; + if ([context respondsToSelector:@selector(invalidatedItemIndexPaths)]) { + hasInvalidatedItemIndexPaths = [context invalidatedItemIndexPaths].count > 0; + } + + if (hasInvalidatedItemIndexPaths + || [context invalidateEverything] + || context.ig_invalidateAllAttributes) { + // invalidates all + _minimumInvalidatedSection = 0; + } else if ([context invalidateDataSourceCounts] && _minimumInvalidatedSection == NSNotFound) { + // invalidate all if count changed and we don't have information on the minimum invalidated section + _minimumInvalidatedSection = 0; + } + + if (context.ig_invalidateSupplementaryAttributes) { + [self _resetSupplementaryAttributesCache]; + } + + [super invalidateLayoutWithContext:context]; +} + ++ (Class)invalidationContextClass { + return [IGListCollectionViewLayoutInvalidationContext class]; +} + +- (UICollectionViewLayoutInvalidationContext *)invalidationContextForBoundsChange:(CGRect)newBounds { + const CGRect oldBounds = self.collectionView.bounds; + + IGListCollectionViewLayoutInvalidationContext *context = + (IGListCollectionViewLayoutInvalidationContext *)[super invalidationContextForBoundsChange:newBounds]; + context.ig_invalidateSupplementaryAttributes = YES; + if (!CGSizeEqualToSize(oldBounds.size, newBounds.size)) { + context.ig_invalidateAllAttributes = YES; + } + return context; +} + +- (BOOL)shouldInvalidateLayoutForBoundsChange:(CGRect)newBounds { + const CGRect oldBounds = self.collectionView.bounds; + + // always invalidate for size changes + if (!CGSizeEqualToSize(oldBounds.size, newBounds.size)) { + return YES; + } + + // if the y origin has changed, only invalidate when using sticky headers + if (CGRectGetMinInDirection(newBounds, self.scrollDirection) != CGRectGetMinInDirection(oldBounds, self.scrollDirection)) { + return self.stickyHeaders; + } + + return NO; +} + +- (void)prepareLayout { + [self _calculateLayoutIfNeeded]; +} + +#pragma mark - Public API + +- (void)setStickyHeaderYOffset:(CGFloat)stickyHeaderYOffset { + IGAssertMainThread(); + + if (_stickyHeaderYOffset != stickyHeaderYOffset) { + _stickyHeaderYOffset = stickyHeaderYOffset; + + IGListCollectionViewLayoutInvalidationContext *invalidationContext = [IGListCollectionViewLayoutInvalidationContext new]; + invalidationContext.ig_invalidateSupplementaryAttributes = YES; + [self invalidateLayoutWithContext:invalidationContext]; + } +} + +#pragma mark - Private API + +- (void)_calculateLayoutIfNeeded { + if (_minimumInvalidatedSection == NSNotFound) { + return; + } + + // purge attribute caches so they are rebuilt + [_attributesCache removeAllObjects]; + [self _resetSupplementaryAttributesCache]; + + UICollectionView *collectionView = self.collectionView; + id dataSource = collectionView.dataSource; + id delegate = (id)collectionView.delegate; + + const NSInteger sectionCount = (IGListExperimentEnabled(_experiments, IGListExperimentUseCollectionViewInsteadOfDataSourceInLayout) + ? [collectionView numberOfSections] + : [dataSource numberOfSectionsInCollectionView:collectionView]); + const UIEdgeInsets contentInset = collectionView.ig_contentInset; + const CGRect contentInsetAdjustedCollectionViewBounds = UIEdgeInsetsInsetRect(collectionView.bounds, contentInset); + + _sectionData.resize(sectionCount); + + CGFloat itemCoordInScrollDirection = 0.0; + CGFloat itemCoordInFixedDirection = 0.0; + CGFloat nextRowCoordInScrollDirection = 0.0; + + // union item frames and optionally the header to find a bounding box of the entire section + CGRect rollingSectionBounds = CGRectZero; + + // populate last valid section information + const NSInteger lastValidSection = _minimumInvalidatedSection - 1; + if (lastValidSection >= 0 && lastValidSection < sectionCount) { + itemCoordInScrollDirection = _sectionData[lastValidSection].lastItemCoordInScrollDirection; + itemCoordInFixedDirection = _sectionData[lastValidSection].lastItemCoordInFixedDirection; + nextRowCoordInScrollDirection = _sectionData[lastValidSection].lastNextRowCoordInScrollDirection; + rollingSectionBounds = _sectionData[lastValidSection].bounds; + } + + for (NSInteger section = _minimumInvalidatedSection; section < sectionCount; section++) { + const NSInteger itemCount = (IGListExperimentEnabled(_experiments, IGListExperimentUseCollectionViewInsteadOfDataSourceInLayout) + ? [collectionView numberOfItemsInSection:section] + : [dataSource collectionView:collectionView numberOfItemsInSection:section]); + const BOOL itemsEmpty = itemCount == 0; + const BOOL hideHeaderWhenItemsEmpty = itemsEmpty && !self.showHeaderWhenEmpty; + _sectionData[section].itemBounds = std::vector(itemCount); + + const CGSize headerSize = [delegate collectionView:collectionView layout:self referenceSizeForHeaderInSection:section]; + const CGSize footerSize = [delegate collectionView:collectionView layout:self referenceSizeForFooterInSection:section]; + const UIEdgeInsets insets = [delegate collectionView:collectionView layout:self insetForSectionAtIndex:section]; + const CGFloat lineSpacing = [delegate collectionView:collectionView layout:self minimumLineSpacingForSectionAtIndex:section]; + const CGFloat interitemSpacing = [delegate collectionView:collectionView layout:self minimumInteritemSpacingForSectionAtIndex:section]; + + const CGSize paddedCollectionViewSize = UIEdgeInsetsInsetRect(contentInsetAdjustedCollectionViewBounds, insets).size; + const UICollectionViewScrollDirection fixedDirection = self.scrollDirection == UICollectionViewScrollDirectionHorizontal ? UICollectionViewScrollDirectionVertical : UICollectionViewScrollDirectionHorizontal; + const CGFloat paddedLengthInFixedDirection = CGSizeGetLengthInDirection(paddedCollectionViewSize, fixedDirection); + const CGFloat headerLengthInScrollDirection = hideHeaderWhenItemsEmpty ? 0 : CGSizeGetLengthInDirection(headerSize, self.scrollDirection); + const CGFloat footerLengthInScrollDirection = hideHeaderWhenItemsEmpty ? 0 : CGSizeGetLengthInDirection(footerSize, self.scrollDirection); + const BOOL headerExists = headerLengthInScrollDirection > 0; + const BOOL footerExists = footerLengthInScrollDirection > 0; + + // start the section accounting for the header size + // header length in scroll direction is subtracted from the sectionBounds when calculating the header bounds after items are done + // this bumps the first row of items over enough to make room for the header + itemCoordInScrollDirection += headerLengthInScrollDirection; + nextRowCoordInScrollDirection += headerLengthInScrollDirection; + + // add the leading inset in fixed direction in case the section falls on the same row as the previous + // if the section is newlined then the coord in fixed direction is reset + itemCoordInFixedDirection += UIEdgeInsetsLeadingInsetInDirection(insets, fixedDirection); + + // the farthest in the fixed direction the frame of an item in this section can go + const CGFloat maxCoordinateInFixedDirection = CGRectGetLengthInDirection(contentInsetAdjustedCollectionViewBounds, fixedDirection) - UIEdgeInsetsTrailingInsetInDirection(insets, fixedDirection); + + for (NSInteger item = 0; item < itemCount; item++) { + NSIndexPath *indexPath = [NSIndexPath indexPathForItem:item inSection:section]; + const CGSize size = [delegate collectionView:collectionView layout:self sizeForItemAtIndexPath:indexPath]; + + IGAssert(CGSizeGetLengthInDirection(size, fixedDirection) <= paddedLengthInFixedDirection + || fabs(CGSizeGetLengthInDirection(size, fixedDirection) - paddedLengthInFixedDirection) < FLT_EPSILON, + @"%@ of item %li in section %li (%.0f pt) must be less than or equal to container (%.0f pt) accounting for section insets %@", + self.scrollDirection == UICollectionViewScrollDirectionVertical ? @"Width" : @"Height", + (long)item, + (long)section, + CGSizeGetLengthInDirection(size, fixedDirection), + CGRectGetLengthInDirection(contentInsetAdjustedCollectionViewBounds, fixedDirection), + NSStringFromUIEdgeInsets(insets)); + + CGFloat itemLengthInFixedDirection = MIN(CGSizeGetLengthInDirection(size, fixedDirection), paddedLengthInFixedDirection); + + // if the origin and length in fixed direction of the item busts the size of the container + // or if this is the first item and the header has a non-zero size + // newline to the next row and reset + // define epsilon to avoid float overflow issue + const CGFloat epsilon = 1.0; + if (itemCoordInFixedDirection + itemLengthInFixedDirection > maxCoordinateInFixedDirection + epsilon + || (item == 0 && headerExists)) { + itemCoordInScrollDirection = nextRowCoordInScrollDirection; + itemCoordInFixedDirection = UIEdgeInsetsLeadingInsetInDirection(insets, fixedDirection); + + + // if newlining, always append line spacing unless its the very first item of the section + if (item > 0) { + itemCoordInScrollDirection += lineSpacing; + } + } + + const CGFloat distanceToEdge = paddedLengthInFixedDirection - (itemCoordInFixedDirection + itemLengthInFixedDirection); + if (self.stretchToEdge && distanceToEdge > 0 && distanceToEdge <= epsilon) { + itemLengthInFixedDirection = paddedLengthInFixedDirection - itemCoordInFixedDirection; + } + + const CGRect rawFrame = (self.scrollDirection == UICollectionViewScrollDirectionVertical) ? + CGRectMake(itemCoordInFixedDirection, + itemCoordInScrollDirection + insets.top, + itemLengthInFixedDirection, + size.height) : + CGRectMake(itemCoordInScrollDirection + insets.left, + itemCoordInFixedDirection, + size.width, + itemLengthInFixedDirection); + const CGRect frame = IGListRectIntegralScaled(rawFrame); + + _sectionData[section].itemBounds[item] = frame; + + // track the max size of the row to find the coord of the next row, adjust for leading inset while iterating items + nextRowCoordInScrollDirection = MAX(CGRectGetMaxInDirection(frame, self.scrollDirection) - UIEdgeInsetsLeadingInsetInDirection(insets, self.scrollDirection), nextRowCoordInScrollDirection); + + // increase the rolling coord in fixed direction appropriately and add item spacing for all items on the same row + itemCoordInFixedDirection += itemLengthInFixedDirection + interitemSpacing; + + // union the rolling section bounds + if (item == 0) { + rollingSectionBounds = frame; + } else { + rollingSectionBounds = CGRectUnion(rollingSectionBounds, frame); + } + } + + const CGRect headerBounds = self.scrollDirection == UICollectionViewScrollDirectionVertical ? + CGRectMake(insets.left, + itemsEmpty ? CGRectGetMaxY(rollingSectionBounds) : CGRectGetMinY(rollingSectionBounds) - headerSize.height, + paddedLengthInFixedDirection, + hideHeaderWhenItemsEmpty ? 0 : headerSize.height) : + CGRectMake(itemsEmpty ? CGRectGetMaxX(rollingSectionBounds) : CGRectGetMinX(rollingSectionBounds) - headerSize.width, + insets.top, + hideHeaderWhenItemsEmpty ? 0 : headerSize.width, + paddedLengthInFixedDirection); + + _sectionData[section].headerBounds = headerBounds; + + if (itemsEmpty) { + rollingSectionBounds = headerBounds; + } + + const CGRect footerBounds = (self.scrollDirection == UICollectionViewScrollDirectionVertical) ? + CGRectMake(insets.left, + CGRectGetMaxY(rollingSectionBounds), + paddedLengthInFixedDirection, + hideHeaderWhenItemsEmpty ? 0 : footerSize.height) : + CGRectMake(CGRectGetMaxX(rollingSectionBounds) + insets.right, + insets.top, + hideHeaderWhenItemsEmpty ? 0 : footerSize.width, + paddedLengthInFixedDirection); + + _sectionData[section].footerBounds = footerBounds; + + // union the header before setting the bounds of the section + // only do this when the header has a size, otherwise the union stretches to box empty space + if (headerExists) { + rollingSectionBounds = CGRectUnion(rollingSectionBounds, headerBounds); + } + if (footerExists) { + rollingSectionBounds = CGRectUnion(rollingSectionBounds, footerBounds); + } + + _sectionData[section].bounds = rollingSectionBounds; + _sectionData[section].insets = insets; + + // bump the coord for the next section with the right insets + itemCoordInFixedDirection += UIEdgeInsetsTrailingInsetInDirection(insets, fixedDirection); + + // find the farthest point in the section and add the trailing inset to find the next row's coord + nextRowCoordInScrollDirection = MAX(nextRowCoordInScrollDirection, CGRectGetMaxInDirection(rollingSectionBounds, self.scrollDirection) + UIEdgeInsetsTrailingInsetInDirection(insets, self.scrollDirection)); + + // keep track of coordinates for partial invalidation + _sectionData[section].lastItemCoordInScrollDirection = itemCoordInScrollDirection; + _sectionData[section].lastItemCoordInFixedDirection = itemCoordInFixedDirection; + _sectionData[section].lastNextRowCoordInScrollDirection = nextRowCoordInScrollDirection; + } + + _minimumInvalidatedSection = NSNotFound; +} + +- (NSRange)_rangeOfSectionsInRect:(CGRect)rect { + NSRange result = NSMakeRange(NSNotFound, 0); + + const NSInteger sectionCount = _sectionData.size(); + for (NSInteger section = 0; section < sectionCount; section++) { + IGListSectionEntry entry = _sectionData[section]; + if (entry.isValid() && CGRectIntersectsRect(entry.bounds, rect)) { + const NSRange sectionRange = NSMakeRange(section, 1); + if (result.location == NSNotFound) { + result = sectionRange; + } else { + result = NSUnionRange(result, sectionRange); + } + } + } + + return result; +} + +- (void)_resetSupplementaryAttributesCache { + [_supplementaryAttributesCache enumerateKeysAndObjectsUsingBlock:^(NSString * _Nonnull key, NSMutableDictionary * _Nonnull attributesCache, BOOL * _Nonnull stop) { + [attributesCache removeAllObjects]; + }]; +} + +#pragma mark - Minimum Invalidated Section + +- (void)didModifySection:(NSInteger)modifiedSection { + _minimumInvalidatedSection = IGListMergeMinimumInvalidatedSection(_minimumInvalidatedSection, modifiedSection); +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayoutCompatible.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayoutCompatible.h new file mode 100644 index 0000000..716ab65 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListCollectionViewLayoutCompatible.h @@ -0,0 +1,33 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + A protocol for layouts that defines interaction with an IGListCollectionView, for recieving updated section indexes. + */ +NS_SWIFT_NAME(ListCollectionViewLayoutCompatible) +@protocol IGListCollectionViewLayoutCompatible + +/** + Called to notify the layout that a specific section was modified before invalidation. This can be used to optimize + layout re-calculation. + + @note When updating a collection view (ex: calling `-insertSections`), `-invalidateLayoutWithContext` gets called on + the layout object. However, the invalidation context doesn't provide details on which index paths are being modified, + which typically forces a full layout re-calculation. Layouts can use this method to keep track of which section + actually needs to be updated on the following `-invalidateLayoutWithContext`. See `IGListCollectionView`. + + @param modifiedSection The section that was modified. + */ +- (void)didModifySection:(NSInteger)modifiedSection; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListDisplayDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListDisplayDelegate.h new file mode 100644 index 0000000..8315f4a --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListDisplayDelegate.h @@ -0,0 +1,65 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; +@class IGListSectionController; + + + +NS_ASSUME_NONNULL_BEGIN + +/** + Implement this protocol to receive display events for a section controller when it is on screen. + */ +NS_SWIFT_NAME(ListDisplayDelegate) +@protocol IGListDisplayDelegate + +/** + Tells the delegate that the specified section controller is about to be displayed. + + @param listAdapter The list adapter for the section controller. + @param sectionController The section controller about to be displayed. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter willDisplaySectionController:(IGListSectionController *)sectionController; + +/** + Tells the delegate that the specified section controller is no longer being displayed. + + @param listAdapter The list adapter for the section controller. + @param sectionController The section controller that is no longer displayed. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didEndDisplayingSectionController:(IGListSectionController *)sectionController; + +/** + Tells the delegate that a cell in the specified list is about to be displayed. + + @param listAdapter The list adapter in which the cell will display. + @param sectionController The section controller that is displaying the cell. + @param cell The cell about to be displayed. + @param index The index of the cell in the section. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter willDisplaySectionController:(IGListSectionController *)sectionController + cell:(UICollectionViewCell *)cell + atIndex:(NSInteger)index; + +/** + Tells the delegate that a cell in the specified list is no longer being displayed. + + @param listAdapter The list adapter in which the cell was displayed. + @param sectionController The section controller that is no longer displaying the cell. + @param cell The cell that is no longer displayed. + @param index The index of the cell in the section. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didEndDisplayingSectionController:(IGListSectionController *)sectionController + cell:(UICollectionViewCell *)cell + atIndex:(NSInteger)index; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListGenericSectionController.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListGenericSectionController.h new file mode 100644 index 0000000..3fa8953 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListGenericSectionController.h @@ -0,0 +1,40 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + This class adds a helper layer to `IGListSectionController` to automatically store a generic object in + `didUpdateToObject:`. + */ +NS_SWIFT_NAME(ListGenericSectionController) +@interface IGListGenericSectionController<__covariant ObjectType> : IGListSectionController + +/** + The object mapped to this section controller. Matches the object provided in + `[IGListAdapterDataSource listAdapter:sectionControllerForObject:]` when this section controller was created and + returned. + + @note This object is briefly `nil` between initialization and the first call to `didUpdateToObject:`. After that, it is + safe to assume that this is non-`nil`. + */ +@property (nonatomic, strong, nullable, readonly) ObjectType object; + +/** + Updates the section controller to a new object. + + @param object The object mapped to this section controller. + + @note This `IGListSectionController` subclass sets its object in this method, so any overrides **must call super**. + */ +- (void)didUpdateToObject:(id)object NS_REQUIRES_SUPER; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListGenericSectionController.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListGenericSectionController.m new file mode 100644 index 0000000..8d15af8 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListGenericSectionController.m @@ -0,0 +1,16 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListGenericSectionController.h" + +@implementation IGListGenericSectionController + +- (void)didUpdateToObject:(id)object { + _object = object; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListKit.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListKit.h new file mode 100644 index 0000000..c352c4e --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListKit.h @@ -0,0 +1,65 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +/** + * Project version number for IGListKit. + */ +FOUNDATION_EXPORT double IGListKitVersionNumber; + +/** + * Project version string for IGListKit. + */ +FOUNDATION_EXPORT const unsigned char IGListKitVersionString[]; + +#if TARGET_OS_EMBEDDED || TARGET_OS_SIMULATOR + +// iOS and tvOS only: + +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import + +#endif + +// Shared (iOS, tvOS, macOS compatible): + +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import +#import diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListReloadDataUpdater.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListReloadDataUpdater.h new file mode 100644 index 0000000..3dc98da --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListReloadDataUpdater.h @@ -0,0 +1,27 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + An `IGListReloadDataUpdater` is a concrete type that conforms to `IGListUpdatingDelegate`. + It is an out-of-box updater for `IGListAdapter` objects to use. + + @note This updater performs simple, synchronous updates using `-[UICollectionView reloadData]`. + */ +IGLK_SUBCLASSING_RESTRICTED +NS_SWIFT_NAME(ListReloadDataUpdater) +@interface IGListReloadDataUpdater : NSObject + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListReloadDataUpdater.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListReloadDataUpdater.m new file mode 100644 index 0000000..bf1fe07 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListReloadDataUpdater.m @@ -0,0 +1,82 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@implementation IGListReloadDataUpdater + +#pragma mark - IGListUpdatingDelegate + +- (NSPointerFunctions *)objectLookupPointerFunctions { + return [NSPointerFunctions pointerFunctionsWithOptions:NSPointerFunctionsObjectPersonality]; +} + +- (void)performUpdateWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + fromObjects:(NSArray *)fromObjects + toObjectsBlock:(IGListToObjectBlock)toObjectsBlock + animated:(BOOL)animated + objectTransitionBlock:(IGListObjectTransitionBlock)objectTransitionBlock + completion:(IGListUpdatingCompletion)completion { + if (toObjectsBlock != nil) { + NSArray *toObjects = toObjectsBlock() ?: @[]; + objectTransitionBlock(toObjects); + } + [self _synchronousReloadDataWithCollectionView:collectionViewBlock()]; + if (completion) { + completion(YES); + } +} + +- (void)performUpdateWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + animated:(BOOL)animated + itemUpdates:(IGListItemUpdateBlock)itemUpdates + completion:(IGListUpdatingCompletion)completion { + itemUpdates(); + [self _synchronousReloadDataWithCollectionView:collectionViewBlock()]; + if (completion) { + completion(YES); + } +} + +- (void)insertItemsIntoCollectionView:(UICollectionView *)collectionView indexPaths:(NSArray *)indexPaths { + [self _synchronousReloadDataWithCollectionView:collectionView]; +} + +- (void)deleteItemsFromCollectionView:(UICollectionView *)collectionView indexPaths:(NSArray *)indexPaths { + [self _synchronousReloadDataWithCollectionView:collectionView]; +} + +- (void)moveItemInCollectionView:(UICollectionView *)collectionView fromIndexPath:(NSIndexPath *)fromIndexPath toIndexPath:(NSIndexPath *)toIndexPath { + [self _synchronousReloadDataWithCollectionView:collectionView]; +} + +- (void)reloadItemInCollectionView:(UICollectionView *)collectionView fromIndexPath:(NSIndexPath *)fromIndexPath toIndexPath:(NSIndexPath *)toIndexPath { + [self _synchronousReloadDataWithCollectionView:collectionView]; +} + +- (void)moveSectionInCollectionView:(UICollectionView *)collectionView fromIndex:(NSInteger)fromIndex toIndex:(NSInteger)toIndex { + [self _synchronousReloadDataWithCollectionView:collectionView]; +} + +- (void)reloadDataWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock reloadUpdateBlock:(IGListReloadUpdateBlock)reloadUpdateBlock completion:(IGListUpdatingCompletion)completion { + reloadUpdateBlock(); + [self _synchronousReloadDataWithCollectionView:collectionViewBlock()]; + if (completion) { + completion(YES); + } +} + +- (void)reloadCollectionView:(UICollectionView *)collectionView sections:(NSIndexSet *)sections { + [self _synchronousReloadDataWithCollectionView:collectionView]; +} + +- (void)_synchronousReloadDataWithCollectionView:(UICollectionView *)collectionView { + [collectionView reloadData]; + [collectionView layoutIfNeeded]; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListScrollDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListScrollDelegate.h new file mode 100644 index 0000000..b53d2b3 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListScrollDelegate.h @@ -0,0 +1,63 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; +@class IGListSectionController; + + + +NS_ASSUME_NONNULL_BEGIN + +/** + Implement this protocol to receive display events for a section controller when it is on screen. + */ +NS_SWIFT_NAME(ListScrollDelegate) +@protocol IGListScrollDelegate + +/** + Tells the delegate that the section controller was scrolled on screen. + + @param listAdapter The list adapter whose collection view was scrolled. + @param sectionController The visible section controller that was scrolled. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didScrollSectionController:(IGListSectionController *)sectionController; + +/** + Tells the delegate that the section controller will be dragged on screen. + + @param listAdapter The list adapter whose collection view will drag. + @param sectionController The visible section controller that will drag. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter willBeginDraggingSectionController:(IGListSectionController *)sectionController; + +/** + Tells the delegate that the section controller did end dragging on screen. + + @param listAdapter The list adapter whose collection view ended dragging. + @param sectionController The visible section controller that ended dragging. + @param decelerate 'Yes' if the scrolling movement will continue, but decelerate, after a touch-up gesture during a + dragging operation. If the value is 'No', scrolling stops immediately upon touch-up. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didEndDraggingSectionController:(IGListSectionController *)sectionController willDecelerate:(BOOL)decelerate; + +@optional + +/** + Tells the delegate that the section controller did end decelerating on screen. + + @param listAdapter The list adapter whose collection view ended decelerating. + @param sectionController The visible section controller that ended decelerating. + + @note This method is `@optional` until the next breaking-change release. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter didEndDeceleratingSectionController:(IGListSectionController *)sectionController; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListSectionController.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListSectionController.h new file mode 100644 index 0000000..d6e5824 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListSectionController.h @@ -0,0 +1,239 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import +#import +#import +#import +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + The base class for section controllers used in a list. This class is intended to be subclassed. + */ +NS_SWIFT_NAME(ListSectionController) +@interface IGListSectionController : NSObject + +/** + Returns the number of items in the section. + + @return A count of items in the list. + + @note The count returned is used to drive the number of cells displayed for this section controller. The default + implementation returns 1. **Calling super is not required.** + */ +- (NSInteger)numberOfItems; + +/** + The specific size for the item at the specified index. + + @param index The row index of the item. + + @return The size for the item at index. + + @note The returned size is not guaranteed to be used. The implementation may query sections for their + layout information at will, or use its own layout metrics. For example, consider a dynamic-text sized list versus a + fixed height-and-width grid. The former will ask each section for a size, and the latter will likely not. The default + implementation returns size zero. **Calling super is not required.** + */ +- (CGSize)sizeForItemAtIndex:(NSInteger)index; + +/** + Return a dequeued cell for a given index. + + @param index The index of the requested row. + + @return A configured `UICollectionViewCell` subclass. + + @note This is your opportunity to do any cell setup and configuration. The infrastructure requests a cell when it + will be used on screen. You should never allocate new cells in this method, instead use the provided adapter to call + one of the dequeue methods on the IGListCollectionContext. The default implementation will assert. **You must override + this method without calling super.** + + @warning Don't call this method to obtain a reference to currently dequeued cells: a new cell will be dequeued + and returned, rather than the existing cell that you may have intended to retrieve. Instead, you can call + `-cellForItemAtIndex:sectionController:` on `IGListCollectionContext` to obtain active cell references. + */ +- (__kindof UICollectionViewCell *)cellForItemAtIndex:(NSInteger)index; + +/** + Updates the section controller to a new object. + + @param object The object mapped to this section controller. + + @note When this method is called, all available contexts and configurations have been set for the section + controller. This method will only be called when the object instance has changed, including from `nil` or a previous + object. **Calling super is not required.** + */ +- (void)didUpdateToObject:(id)object; + +/** + Tells the section controller that the cell at the specified index path was selected. + + @param index The index of the selected cell. + + @note The default implementation does nothing. **Calling super is not required.** + */ +- (void)didSelectItemAtIndex:(NSInteger)index; + +/** + Tells the section controller that the cell at the specified index path was deselected. + + @param index The index of the deselected cell. + + @note The default implementation does nothing. **Calling super is not required.** + */ +- (void)didDeselectItemAtIndex:(NSInteger)index; + +/** + Tells the section controller that the cell at the specified index path was highlighted. + + @param index The index of the highlighted cell. + + @note The default implementation does nothing. **Calling super is not required.** + */ +- (void)didHighlightItemAtIndex:(NSInteger)index; + +/** + Tells the section controller that the cell at the specified index path was unhighlighted. + + @param index The index of the unhighlighted cell. + + @note The default implementation does nothing. **Calling super is not required.** + */ +- (void)didUnhighlightItemAtIndex:(NSInteger)index; + +/** + Identifies whether an object can be moved through interactive reordering. + + @param index The index of the object in the list. + + @return `YES` if the object is allowed to move, otherwise `NO`. + + @note Interactive reordering is supported both for items within a single section, as well as for reordering sections + themselves when sections contain only one item. The default implementation returns false. + */ +- (BOOL)canMoveItemAtIndex:(NSInteger)index; + +/** + Notifies the section that a list object should move within a section as the result of interactive reordering. + + @param sourceIndex The starting index of the object. + @param destinationIndex The ending index of the object. + + @note this method must be implemented if interactive reordering is enabled. + */ +- (void)moveObjectFromIndex:(NSInteger)sourceIndex toIndex:(NSInteger)destinationIndex NS_AVAILABLE_IOS(9_0); + +/** + The view controller housing the adapter that created this section controller. + + @note Use this view controller to push, pop, present, or do other custom transitions. + + @warning It is considered very bad practice to cast this to a known view controller + and call methods on it other than for navigations and transitions. + */ +@property (nonatomic, weak, nullable, readonly) UIViewController *viewController; + +/** + A context object for interacting with the collection. + + Use this property for accessing the collection size, dequeuing cells, reloading, inserting, deleting, etc. + */ +@property (nonatomic, weak, nullable, readonly) id collectionContext; + +/** + Returns the section within the list for this section controller. + + @note This value also relates to the section within a `UICollectionView` that this section controller's cells belong. + It also relates to the `-[NSIndexPath section]` value for individual cells within the collection view. + */ +@property (nonatomic, assign, readonly) NSInteger section; + +/** + Returns `YES` if the section controller is the first section in the list, `NO` otherwise. + */ +@property (nonatomic, assign, readonly) BOOL isFirstSection; + +/** + Returns `YES` if the section controller is the last section in the list, `NO` otherwise. + */ +@property (nonatomic, assign, readonly) BOOL isLastSection; + +/** + The margins used to lay out content in the section controller. + + @see `-[UICollectionViewFlowLayout sectionInset]`. + */ +@property (nonatomic, assign) UIEdgeInsets inset; + +/** + The minimum spacing to use between rows of items. + + @see `-[UICollectionViewFlowLayout minimumLineSpacing]`. + */ +@property (nonatomic, assign) CGFloat minimumLineSpacing; + +/** + The minimum spacing to use between items in the same row. + + @see `-[UICollectionViewFlowLayout minimumInteritemSpacing]`. + */ +@property (nonatomic, assign) CGFloat minimumInteritemSpacing; + +/** + The supplementary view source for the section controller. Can be `nil`. + + @return An object that conforms to `IGListSupplementaryViewSource` or `nil`. + + @note You may wish to return `self` if your section controller implements this protocol. + */ +@property (nonatomic, weak, nullable) id supplementaryViewSource; + +/** + An object that handles display events for the section controller. Can be `nil`. + + @return An object that conforms to `IGListDisplayDelegate` or `nil`. + + @note You may wish to return `self` if your section controller implements this protocol. + */ +@property (nonatomic, weak, nullable) id displayDelegate; + +/** + An object that handles working range events for the section controller. Can be `nil`. + + @return An object that conforms to `IGListWorkingRangeDelegate` or `nil`. + + @note You may wish to return `self` if your section controller implements this protocol. + */ +@property (nonatomic, weak, nullable) id workingRangeDelegate; + +/** + An object that handles scroll events for the section controller. Can be `nil`. + + @return An object that conforms to `IGListScrollDelegate` or `nil`. + + @note You may wish to return `self` if your section controller implements this protocol. + */ +@property (nonatomic, weak, nullable) id scrollDelegate; + +/** + An object that handles transition events for the section controller. Can be `nil`. + + @return An object that conforms to `IGListTransitionDelegat` or `nil`. + + @note You may wish to return `self` if your section controller implements this protocol. + */ +@property (nonatomic, weak, nullable) id transitionDelegate; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListSectionController.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListSectionController.m new file mode 100644 index 0000000..f880339 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListSectionController.m @@ -0,0 +1,103 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListSectionControllerInternal.h" + +#import +#import + +static NSString * const kIGListSectionControllerThreadKey = @"kIGListSectionControllerThreadKey"; + +@interface IGListSectionControllerThreadContext : NSObject +@property (nonatomic, weak) UIViewController *viewController; +@property (nonatomic, weak) id collectionContext; +@end +@implementation IGListSectionControllerThreadContext +@end + +static NSMutableArray *threadContextStack(void) { + IGAssertMainThread(); + NSMutableDictionary *threadDictionary = [[NSThread currentThread] threadDictionary]; + NSMutableArray *stack = threadDictionary[kIGListSectionControllerThreadKey]; + if (stack == nil) { + stack = [NSMutableArray new]; + threadDictionary[kIGListSectionControllerThreadKey] = stack; + } + return stack; +} + +void IGListSectionControllerPushThread(UIViewController *viewController, id collectionContext) { + IGListSectionControllerThreadContext *context = [IGListSectionControllerThreadContext new]; + context.viewController = viewController; + context.collectionContext = collectionContext; + + [threadContextStack() addObject:context]; +} + +void IGListSectionControllerPopThread(void) { + NSMutableArray *stack = threadContextStack(); + IGAssert(stack.count > 0, @"IGListSectionController thread stack is empty"); + [stack removeLastObject]; +} + +@implementation IGListSectionController + +- (instancetype)init { + if (self = [super init]) { + IGListSectionControllerThreadContext *context = [threadContextStack() lastObject]; + _viewController = context.viewController; + _collectionContext = context.collectionContext; + + if (_collectionContext == nil) { + IGLKLog(@"Warning: Creating %@ outside of -[IGListAdapterDataSource listAdapter:sectionControllerForObject:]. Collection context and view controller will be set later.", + NSStringFromClass([self class])); + } + + _minimumInteritemSpacing = 0.0; + _minimumLineSpacing = 0.0; + _inset = UIEdgeInsetsZero; + _section = NSNotFound; + } + return self; +} + +- (NSInteger)numberOfItems { + return 1; +} + +- (CGSize)sizeForItemAtIndex:(NSInteger)index { + return CGSizeZero; +} + +- (__kindof UICollectionViewCell *)cellForItemAtIndex:(NSInteger)index { + IGFailAssert(@"Section controller %@ must override %s:", self, __PRETTY_FUNCTION__); + return nil; +} + +- (void)didUpdateToObject:(id)object {} + +- (void)didSelectItemAtIndex:(NSInteger)index {} + +- (void)didDeselectItemAtIndex:(NSInteger)index {} + +- (void)didHighlightItemAtIndex:(NSInteger)index {} + +- (void)didUnhighlightItemAtIndex:(NSInteger)index {} + +- (BOOL)canMoveItemAtIndex:(NSInteger)index { + return NO; +} + +- (BOOL)canMoveItemAtIndex:(NSInteger)sourceItemIndex toIndex:(NSInteger)destinationItemIndex { + return [self canMoveItemAtIndex:sourceItemIndex]; +} + +- (void)moveObjectFromIndex:(NSInteger)sourceIndex toIndex:(NSInteger)destinationIndex { + IGFailAssert(@"Section controller %@ must override %s if interactive reordering is enabled.", self, __PRETTY_FUNCTION__); +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListSingleSectionController.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListSingleSectionController.h new file mode 100644 index 0000000..2618fcf --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListSingleSectionController.h @@ -0,0 +1,144 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import + +NS_ASSUME_NONNULL_BEGIN + + +/** + A block used to configure cells. + + @param item The model with which to configure the cell. + @param cell The cell to configure. + */ +NS_SWIFT_NAME(ListSingleSectionCellConfigureBlock) +typedef void (^IGListSingleSectionCellConfigureBlock)(id item, __kindof UICollectionViewCell *cell); + +/** + A block that returns the size for the cell given the collection context. + + @param item The model for the section. + @param collectionContext The collection context for the section. + + @return The size for the cell. + */ +NS_SWIFT_NAME(ListSingleSectionCellSizeBlock) +typedef CGSize (^IGListSingleSectionCellSizeBlock)(id item, id _Nullable collectionContext); + +@class IGListSingleSectionController; + +/** + A delegate that can receive selection events on an `IGListSingleSectionController`. + */ +NS_SWIFT_NAME(ListSingleSectionControllerDelegate) +@protocol IGListSingleSectionControllerDelegate + +/** + Tells the delegate that the section controller was selected. + + @param sectionController The section controller that was selected. + @param object The model for the given section. + */ +- (void)didSelectSectionController:(IGListSingleSectionController *)sectionController + withObject:(id)object; + +@optional + +/** + Tells the delegate that the section controller was deselected. + + @param sectionController The section controller that was deselected. + @param object The model for the given section. + + @note Method is `@optional` until the 4.0.0 release where it will become required. + */ +- (void)didDeselectSectionController:(IGListSingleSectionController *)sectionController + withObject:(id)object; + +@end + +/** + This section controller is meant to make building simple, single-cell lists easier. By providing the type of cell, a block + to configure the cell, and a block to return the size of a cell, you can use an `IGListAdapter`-powered list with a + simpler architecture. + */ +IGLK_SUBCLASSING_RESTRICTED +NS_SWIFT_NAME(ListSingleSectionController) +@interface IGListSingleSectionController : IGListSectionController + +/** + Creates a new section controller for a given cell type that will always have only one cell when present in a list. + + @param cellClass The `UICollectionViewCell` subclass for the single cell. + @param configureBlock A block that configures the cell with the item given to the section controller. + @param sizeBlock A block that returns the size for the cell given the collection context. + + @return A new section controller. + + @warning Be VERY CAREFUL not to create retain cycles by holding strong references to: the object that owns the adapter + (usually `self`) or the `IGListAdapter`. Pass in locally scoped objects or use `weak` references! + */ +- (instancetype)initWithCellClass:(Class)cellClass + configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock + sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock; + +/** + Creates a new section controller for a given nib name and bundle that will always have only one cell when present in a list. + + @param nibName The name of the nib file for the single cell. + @param bundle The bundle in which to search for the nib file. If `nil`, this method looks for the file in the main bundle. + @param configureBlock A block that configures the cell with the item given to the section controller. + @param sizeBlock A block that returns the size for the cell given the collection context. + + @return A new section controller. + + @warning Be VERY CAREFUL not to create retain cycles by holding strong references to: the object that owns the adapter + (usually `self`) or the `IGListAdapter`. Pass in locally scoped objects or use `weak` references! + */ +- (instancetype)initWithNibName:(NSString *)nibName + bundle:(nullable NSBundle *)bundle + configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock + sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock; + +/** + Creates a new section controller for a given storyboard cell identifier that will always have only one cell when present in a list. + + @param identifier The identifier of the cell prototype in storyboard. + @param configureBlock A block that configures the cell with the item given to the section controller. + @param sizeBlock A block that returns the size for the cell given the collection context. + + @return A new section controller. + + @warning Be VERY CAREFUL not to create retain cycles by holding strong references to: the object that owns the adapter + (usually `self`) or the `IGListAdapter`. Pass in locally scoped objects or use `weak` references! + */ +- (instancetype)initWithStoryboardCellIdentifier:(NSString *)identifier + configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock + sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock; + +/** + An optional delegate that handles selection and deselection. + */ +@property (nonatomic, weak, nullable) id selectionDelegate; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListSingleSectionController.m b/Demo/Pods/IGListKit/Source/IGListKit/IGListSingleSectionController.m new file mode 100644 index 0000000..5206279 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListSingleSectionController.m @@ -0,0 +1,116 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListSingleSectionController.h" + +#import + +@interface IGListSingleSectionController () + +@property (nonatomic, strong, readonly) NSString *nibName; +@property (nonatomic, strong, readonly) NSBundle *bundle; +@property (nonatomic, strong, readonly) NSString *identifier; +@property (nonatomic, strong, readonly) Class cellClass; +@property (nonatomic, strong, readonly) IGListSingleSectionCellConfigureBlock configureBlock; +@property (nonatomic, strong, readonly) IGListSingleSectionCellSizeBlock sizeBlock; + +@property (nonatomic, strong) id item; + +@end + +@implementation IGListSingleSectionController + +- (instancetype)initWithCellClass:(Class)cellClass + configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock + sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock { + IGParameterAssert(cellClass != nil); + IGParameterAssert(configureBlock != nil); + IGParameterAssert(sizeBlock != nil); + if (self = [super init]) { + _cellClass = cellClass; + _configureBlock = [configureBlock copy]; + _sizeBlock = [sizeBlock copy]; + } + return self; +} + +- (instancetype)initWithNibName:(NSString *)nibName + bundle:(NSBundle *)bundle + configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock + sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock { + IGParameterAssert(nibName != nil); + IGParameterAssert(configureBlock != nil); + IGParameterAssert(sizeBlock != nil); + if (self = [super init]) { + _nibName = [nibName copy]; + _bundle = bundle; + _configureBlock = [configureBlock copy]; + _sizeBlock = [sizeBlock copy]; + } + return self; +} + +- (instancetype)initWithStoryboardCellIdentifier:(NSString *)identifier + configureBlock:(IGListSingleSectionCellConfigureBlock)configureBlock + sizeBlock:(IGListSingleSectionCellSizeBlock)sizeBlock { + IGParameterAssert(identifier.length > 0); + IGParameterAssert(configureBlock != nil); + IGParameterAssert(sizeBlock != nil); + if (self = [super init]) { + _identifier = [identifier copy]; + _configureBlock = [configureBlock copy]; + _sizeBlock = [sizeBlock copy]; + } + return self; + +} + +#pragma mark - IGListSectionController Overrides + +- (NSInteger)numberOfItems { + return 1; +} + +- (CGSize)sizeForItemAtIndex:(NSInteger)index { + return self.sizeBlock(self.item, self.collectionContext); +} + +- (UICollectionViewCell *)cellForItemAtIndex:(NSInteger)index { + IGParameterAssert(index == 0); + id cell; + id collectionContext = self.collectionContext; + if ([self.nibName length] > 0) { + cell = [collectionContext dequeueReusableCellWithNibName:self.nibName + bundle:self.bundle + forSectionController:self + atIndex:index]; + } else if ([self.identifier length] > 0) { + cell = [collectionContext dequeueReusableCellFromStoryboardWithIdentifier:self.identifier + forSectionController:self + atIndex:index]; + } else { + cell = [collectionContext dequeueReusableCellOfClass:self.cellClass forSectionController:self atIndex:index]; + } + self.configureBlock(self.item, cell); + return cell; +} + +- (void)didUpdateToObject:(id)object { + self.item = object; +} + +- (void)didSelectItemAtIndex:(NSInteger)index { + [self.selectionDelegate didSelectSectionController:self withObject:self.item]; +} + +- (void)didDeselectItemAtIndex:(NSInteger)index { + if ([self.selectionDelegate respondsToSelector:@selector(didDeselectSectionController:withObject:)]) { + [self.selectionDelegate didDeselectSectionController:self withObject:self.item]; + } +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListSupplementaryViewSource.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListSupplementaryViewSource.h new file mode 100644 index 0000000..4c22f03 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListSupplementaryViewSource.h @@ -0,0 +1,53 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + Conform to this protocol to provide information about a list's supplementary views. This data is used in + `IGListAdapter` which then configures and maintains a `UICollectionView`. The supplementary API reflects that in + `UICollectionView`, `UICollectionViewLayout`, and `UICollectionViewDataSource`. + */ +NS_SWIFT_NAME(ListSupplementaryViewSource) +@protocol IGListSupplementaryViewSource + +/** + Asks the SupplementaryViewSource for an array of supported element kinds. + + @return An array of element kind strings that the supplementary source handles. + */ +- (NSArray *)supportedElementKinds; + +/** + Asks the SupplementaryViewSource for a configured supplementary view for the specified kind and index. + + @param elementKind The kind of supplementary view being requested + @param index The index for the supplementary veiw being requested. + + @note This is your opportunity to do any supplementary view setup and configuration. + + @warning You should never allocate new views in this method. Instead deque a view from the `IGListCollectionContext`. + */ +- (__kindof UICollectionReusableView *)viewForSupplementaryElementOfKind:(NSString *)elementKind + atIndex:(NSInteger)index; + +/** + Asks the SupplementaryViewSource for the size of a supplementary view for the given kind and index path. + + @param elementKind The kind of supplementary view. + @param index The index of the requested view. + + @return The size for the supplementary view. + */ +- (CGSize)sizeForSupplementaryViewOfKind:(NSString *)elementKind + atIndex:(NSInteger)index; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListTransitionDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListTransitionDelegate.h new file mode 100644 index 0000000..db87ff6 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListTransitionDelegate.h @@ -0,0 +1,34 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +/** + Conform to `IGListTransitionDelegate` to provide customized layout information for a collection view. + */ +@protocol IGListTransitionDelegate + +/** + Asks the delegate to customize and return the starting layout information for an item being inserted into the collection view. + + @param listAdapter The adapter controlling the list. + @param attributes The starting layout information for an item being inserted into the collection view. + @param sectionController The section controller to perform the transition on. + @param index The index of the item being inserted. + */ +- (UICollectionViewLayoutAttributes *)listAdapter:(IGListAdapter *)listAdapter customizedInitialLayoutAttributes:(UICollectionViewLayoutAttributes *)attributes sectionController:(IGListSectionController *)sectionController atIndex:(NSInteger)index; + +/** + Asks the delegate to customize and return the final layout information for an item that is about to be removed from the collection view. + + @param listAdapter The adapter controlling the list. + @param attributes The final layout information for an item that is about to be removed from the collection view. + @param sectionController The section controller to perform the transition on. + @param index The index of the item being deleted. + */ +- (UICollectionViewLayoutAttributes *)listAdapter:(IGListAdapter *)listAdapter customizedFinalLayoutAttributes:(UICollectionViewLayoutAttributes *)attributes sectionController:(IGListSectionController *)sectionController atIndex:(NSInteger)index; + +@end + diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListUpdatingDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListUpdatingDelegate.h new file mode 100644 index 0000000..dc8af39 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListUpdatingDelegate.h @@ -0,0 +1,179 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@protocol IGListDiffable; + +NS_ASSUME_NONNULL_BEGIN + +/** + A completion block to execute when updates are finished. + + @param finished Specifies whether or not the update finished. + */ +NS_SWIFT_NAME(ListUpdatingCompletion) +typedef void (^IGListUpdatingCompletion)(BOOL finished); + +/** + A block to be called when the adapter applies changes to the collection view. + + @param toObjects The new objects in the collection. + */ +NS_SWIFT_NAME(ListObjectTransitionBlock) +typedef void (^IGListObjectTransitionBlock)(NSArray *toObjects); + +/// A block that contains all of the updates. +NS_SWIFT_NAME(ListItemUpdateBlock) +typedef void (^IGListItemUpdateBlock)(void); + +/// A block to be called when an adapter reloads the collection view. +NS_SWIFT_NAME(ListReloadUpdateBlock) +typedef void (^IGListReloadUpdateBlock)(void); + +/// A block that returns an array of objects to transition to. +NS_SWIFT_NAME(ListToObjectBlock) +typedef NSArray * _Nullable (^IGListToObjectBlock)(void); + +/// A block that returns a collection view to perform updates on. +NS_SWIFT_NAME(ListCollectionViewBlock) +typedef UICollectionView * _Nullable (^IGListCollectionViewBlock)(void); + +/** + Implement this protocol in order to handle both section and row based update events. Implementation should forward or + coalesce these events to a backing store or collection. + */ +NS_SWIFT_NAME(ListUpdatingDelegate) +@protocol IGListUpdatingDelegate + +/** + Asks the delegate for the pointer functions for looking up an object in a collection. + + @return Pointer functions for looking up an object in a collection. + + @note Since the updating delegate is responsible for transitioning between object sets, it becomes the "source of + truth" for how objects and their corresponding section controllers are mapped. This allows the updater to control if + objects are looked up by pointer, or more traditionally, with `-hash`/`-isEqual`. + + For behavior similar to `NSDictionary`, simply return + `+[NSPointerFunctions pointerFunctionsWithOptions:NSPointerFunctionsObjectPersonality]`. + */ +- (NSPointerFunctions *)objectLookupPointerFunctions; + +/** + Tells the delegate to perform a section transition from an old array of objects to a new one. + + @param collectionViewBlock A block returning the collecion view to perform updates on. + @param fromObjects The previous objects in the collection view. Objects must conform to `IGListDiffable`. + @param toObjectsBlock A block returning the new objects in the collection view. Objects must conform to `IGListDiffable`. + @param animated A flag indicating if the transition should be animated. + @param objectTransitionBlock A block that must be called when the adapter applies changes to the collection view. + @param completion A completion block to execute when the update is finished. + + @note Implementations determine how to transition between objects. You can perform a diff on the objects, reload + each section, or simply call `-reloadData` on the collection view. In the end, the collection view must be setup with a + section for each object in the `toObjects` array. + + The `objectTransitionBlock` block should be called prior to making any `UICollectionView` updates, passing in the `toObjects` + that the updater is applying. + */ +- (void)performUpdateWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + fromObjects:(nullable NSArray> *)fromObjects + toObjectsBlock:(nullable IGListToObjectBlock)toObjectsBlock + animated:(BOOL)animated + objectTransitionBlock:(IGListObjectTransitionBlock)objectTransitionBlock + completion:(nullable IGListUpdatingCompletion)completion; + +/** + Tells the delegate to perform item inserts at the given index paths. + + @param collectionView The collection view on which to perform the transition. + @param indexPaths The index paths to insert items into. + */ +- (void)insertItemsIntoCollectionView:(UICollectionView *)collectionView indexPaths:(NSArray *)indexPaths; + +/** + Tells the delegate to perform item deletes at the given index paths. + + @param collectionView The collection view on which to perform the transition. + @param indexPaths The index paths to delete items from. + */ +- (void)deleteItemsFromCollectionView:(UICollectionView *)collectionView indexPaths:(NSArray *)indexPaths; + +/** + Tells the delegate to move an item from and to given index paths. + + @param collectionView The collection view on which to perform the transition. + @param fromIndexPath The source index path of the item to move. + @param toIndexPath The destination index path of the item to move. + */ +- (void)moveItemInCollectionView:(UICollectionView *)collectionView + fromIndexPath:(NSIndexPath *)fromIndexPath + toIndexPath:(NSIndexPath *)toIndexPath; + +/** + Tells the delegate to reload an item from and to given index paths. + + @param collectionView The collection view on which to perform the transition. + @param fromIndexPath The source index path of the item to reload. + @param toIndexPath The destination index path of the item to reload. + + @note Since UICollectionView is unable to handle calling -[UICollectionView reloadItemsAtIndexPaths:] safely while also + executing insert and delete operations in the same batch updates, the updater must know about the origin and + destination of the reload to perform a safe transition. + */ +- (void)reloadItemInCollectionView:(UICollectionView *)collectionView + fromIndexPath:(NSIndexPath *)fromIndexPath + toIndexPath:(NSIndexPath *)toIndexPath; + +/** + Tells the delegate to move a section from and to given indexes. + + @param collectionView The collection view on which to perform the transition. + @param fromIndex The source index of the section to move. + @param toIndex The destination index of the section to move. + */ +- (void)moveSectionInCollectionView:(UICollectionView *)collectionView + fromIndex:(NSInteger)fromIndex + toIndex:(NSInteger)toIndex; + +/** + Completely reload data in the collection. + + @param collectionViewBlock A block returning the collecion view to reload. + @param reloadUpdateBlock A block that must be called when the adapter reloads the collection view. + @param completion A completion block to execute when the reload is finished. + */ +- (void)reloadDataWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + reloadUpdateBlock:(IGListReloadUpdateBlock)reloadUpdateBlock + completion:(nullable IGListUpdatingCompletion)completion; + +/** + Completely reload each section in the collection view. + + @param collectionView The collection view to reload. + @param sections The sections to reload. + */ +- (void)reloadCollectionView:(UICollectionView *)collectionView sections:(NSIndexSet *)sections; + +/** + Perform an item update block in the collection view. + + @param collectionViewBlock A block returning the collecion view to perform updates on. + @param animated A flag indicating if the transition should be animated. + @param itemUpdates A block containing all of the updates. + @param completion A completion block to execute when the update is finished. + */ +- (void)performUpdateWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock + animated:(BOOL)animated + itemUpdates:(IGListItemUpdateBlock)itemUpdates + completion:(nullable IGListUpdatingCompletion)completion; + +@end + +NS_ASSUME_NONNULL_END + diff --git a/Demo/Pods/IGListKit/Source/IGListKit/IGListWorkingRangeDelegate.h b/Demo/Pods/IGListKit/Source/IGListKit/IGListWorkingRangeDelegate.h new file mode 100644 index 0000000..40bd292 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/IGListWorkingRangeDelegate.h @@ -0,0 +1,44 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; +@class IGListSectionController; + + + +NS_ASSUME_NONNULL_BEGIN + +/** + Implement this protocol to receive working range events for a list. + + The working range is a range *near* the viewport in which you can begin preparing content for display. For example, + you could begin decoding images, or warming text caches. + */ +NS_SWIFT_NAME(ListWorkingRangeDelegate) +@protocol IGListWorkingRangeDelegate + +/** + Notifies the delegate that an section controller will enter the working range. + + @param listAdapter The adapter controlling the list. + @param sectionController The section controller entering the range. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter sectionControllerWillEnterWorkingRange:(IGListSectionController *)sectionController; + +/** + Notifies the delegate that an section controller exited the working range. + + @param listAdapter The adapter controlling the list. + @param sectionController The section controller that exited the range. + */ +- (void)listAdapter:(IGListAdapter *)listAdapter sectionControllerDidExitWorkingRange:(IGListSectionController *)sectionController; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+DebugDescription.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+DebugDescription.h new file mode 100644 index 0000000..e5474df --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+DebugDescription.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@interface IGListAdapter (DebugDescription) + +- (NSArray *)debugDescriptionLines; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+DebugDescription.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+DebugDescription.m new file mode 100644 index 0000000..55e4164 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+DebugDescription.m @@ -0,0 +1,76 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListAdapter+DebugDescription.h" + +#import "IGListAdapterInternal.h" +#import "IGListAdapterUpdater+DebugDescription.h" +#import "IGListDebuggingUtilities.h" +#import "IGListSectionMap+DebugDescription.h" +#import "UICollectionView+DebugDescription.h" + +@implementation IGListAdapter (DebugDescription) + +- (NSString *)debugDescription { + NSMutableArray *lines = [NSMutableArray arrayWithObject:[NSString stringWithFormat:@"IGListAdapter %p:", self]]; + [lines addObjectsFromArray:IGListDebugIndentedLines([self debugDescriptionLines])]; + return [lines componentsJoinedByString:@"\n"]; +} + +- (NSArray *)debugDescriptionLines { + NSMutableArray *debug = [NSMutableArray new]; +#if IGLK_DEBUG_DESCRIPTION_ENABLED + [debug addObject:[NSString stringWithFormat:@"Updater type: %@", NSStringFromClass(self.updater.class)]]; + [debug addObject:[NSString stringWithFormat:@"Data source: %@", self.dataSource]]; + [debug addObject:[NSString stringWithFormat:@"Collection view delegate: %@", self.collectionViewDelegate]]; + [debug addObject:[NSString stringWithFormat:@"Scroll view delegate: %@", self.scrollViewDelegate]]; + [debug addObject:[NSString stringWithFormat:@"Is in update block: %@", IGListDebugBOOL(self.isInUpdateBlock)]]; + [debug addObject:[NSString stringWithFormat:@"View controller: %@", self.viewController]]; + if (@available(iOS 10.0, tvOS 10, *)) { + [debug addObject:[NSString stringWithFormat:@"Is prefetching enabled: %@", IGListDebugBOOL(self.collectionView.isPrefetchingEnabled)]]; + } + + if (self.registeredCellIdentifiers.count > 0) { + [debug addObject:@"Registered cell identifiers:"]; + [debug addObject:[self.registeredCellIdentifiers description]]; + } + + if (self.registeredNibNames.count > 0) { + [debug addObject:@"Registered nib names:"]; + [debug addObject:[self.registeredNibNames description]]; + } + + if (self.registeredSupplementaryViewIdentifiers.count > 0) { + [debug addObject:@"Registered supplementary view identifiers:"]; + [debug addObject:[self.registeredSupplementaryViewIdentifiers description]]; + } + + if (self.registeredSupplementaryViewNibNames.count > 0) { + [debug addObject:@"Registered supplementary view nib names:"]; + [debug addObject:self.registeredSupplementaryViewNibNames]; + } + + if ([self.updater isKindOfClass:[IGListAdapterUpdater class]]) { + [debug addObject:[NSString stringWithFormat:@"IGListAdapterUpdater instance %p:", self.updater]]; + [debug addObjectsFromArray:IGListDebugIndentedLines([(IGListAdapterUpdater *)self.updater debugDescriptionLines])]; + } + + [debug addObject:@"Section map details:"]; + [debug addObjectsFromArray:IGListDebugIndentedLines([self.sectionMap debugDescriptionLines])]; + + if (self.previousSectionMap != nil) { + [debug addObject:@"Previous section map details:"]; + [debug addObjectsFromArray:IGListDebugIndentedLines([self.previousSectionMap debugDescriptionLines])]; + } + + [debug addObject:@"Collection view details:"]; + [debug addObjectsFromArray:IGListDebugIndentedLines([self.collectionView debugDescriptionLines])]; +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED + return debug; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+UICollectionView.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+UICollectionView.h new file mode 100644 index 0000000..e3a8aef --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+UICollectionView.h @@ -0,0 +1,18 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import +#import + +@interface IGListAdapter (UICollectionView) +< +UICollectionViewDataSource, +IGListCollectionViewDelegateLayout +> +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+UICollectionView.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+UICollectionView.m new file mode 100644 index 0000000..c382f1a --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapter+UICollectionView.m @@ -0,0 +1,307 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListAdapter+UICollectionView.h" + +#import +#import +#import +#import + +@implementation IGListAdapter (UICollectionView) + +#pragma mark - UICollectionViewDataSource + +- (NSInteger)numberOfSectionsInCollectionView:(UICollectionView *)collectionView { + return self.sectionMap.objects.count; +} + +- (NSInteger)collectionView:(UICollectionView *)collectionView numberOfItemsInSection:(NSInteger)section { + IGListSectionController * sectionController = [self sectionControllerForSection:section]; + IGAssert(sectionController != nil, @"Nil section controller for section %li for item %@. Check your -diffIdentifier and -isEqual: implementations.", + (long)section, [self.sectionMap objectForSection:section]); + const NSInteger numberOfItems = [sectionController numberOfItems]; + IGAssert(numberOfItems >= 0, @"Cannot return negative number of items %li for section controller %@.", (long)numberOfItems, sectionController); + return numberOfItems; +} + +- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView cellForItemAtIndexPath:(NSIndexPath *)indexPath { + id performanceDelegate = self.performanceDelegate; + [performanceDelegate listAdapterWillCallDequeueCell:self]; + + IGListSectionController *sectionController = [self sectionControllerForSection:indexPath.section]; + + // flag that a cell is being dequeued in case it tries to access a cell in the process + _isDequeuingCell = YES; + UICollectionViewCell *cell = [sectionController cellForItemAtIndex:indexPath.item]; + _isDequeuingCell = NO; + + IGAssert(cell != nil, @"Returned a nil cell at indexPath <%@> from section controller: <%@>", indexPath, sectionController); + + // associate the section controller with the cell so that we know which section controller is using it + [self mapView:cell toSectionController:sectionController]; + + [performanceDelegate listAdapter:self didCallDequeueCell:cell onSectionController:sectionController atIndex:indexPath.item]; + return cell; +} + +- (UICollectionReusableView *)collectionView:(UICollectionView *)collectionView viewForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath { + IGListSectionController *sectionController = [self sectionControllerForSection:indexPath.section]; + id supplementarySource = [sectionController supplementaryViewSource]; + UICollectionReusableView *view = [supplementarySource viewForSupplementaryElementOfKind:kind atIndex:indexPath.item]; + IGAssert(view != nil, @"Returned a nil supplementary view at indexPath <%@> from section controller: <%@>, supplementary source: <%@>", indexPath, sectionController, supplementarySource); + + // associate the section controller with the cell so that we know which section controller is using it + [self mapView:view toSectionController:sectionController]; + + return view; +} + +- (BOOL)collectionView:(UICollectionView *)collectionView canMoveItemAtIndexPath:(NSIndexPath *)indexPath { + const NSInteger sectionIndex = indexPath.section; + const NSInteger itemIndex = indexPath.item; + + IGListSectionController *sectionController = [self sectionControllerForSection:sectionIndex]; + return [sectionController canMoveItemAtIndex:itemIndex]; +} + +- (void)collectionView:(UICollectionView *)collectionView + moveItemAtIndexPath:(NSIndexPath *)sourceIndexPath + toIndexPath:(NSIndexPath *)destinationIndexPath { + + const NSInteger sourceSectionIndex = sourceIndexPath.section; + const NSInteger destinationSectionIndex = destinationIndexPath.section; + const NSInteger sourceItemIndex = sourceIndexPath.item; + const NSInteger destinationItemIndex = destinationIndexPath.item; + + IGListSectionController *sourceSectionController = [self sectionControllerForSection:sourceSectionIndex]; + IGListSectionController *destinationSectionController = [self sectionControllerForSection:destinationSectionIndex]; + + // this is a move within a section + if (sourceSectionController == destinationSectionController) { + + if ([sourceSectionController canMoveItemAtIndex:sourceItemIndex toIndex:destinationItemIndex]) { + [self moveInSectionControllerInteractive:sourceSectionController + fromIndex:sourceItemIndex + toIndex:destinationItemIndex]; + } else { + // otherwise this is a move of an _item_ from one section to another section + // we need to revert the change as it's too late to cancel + [self revertInvalidInteractiveMoveFromIndexPath:sourceIndexPath toIndexPath:destinationIndexPath]; + } + return; + } + + // this is a reordering of sections themselves + if ([sourceSectionController numberOfItems] == 1 && [destinationSectionController numberOfItems] == 1) { + + // perform view changes in the collection view + [self moveSectionControllerInteractive:sourceSectionController + fromIndex:sourceSectionIndex + toIndex:destinationSectionIndex]; + return; + } + + // otherwise this is a move of an _item_ from one section to another section + // this is not currently supported, so we need to revert the change as it's too late to cancel + [self revertInvalidInteractiveMoveFromIndexPath:sourceIndexPath toIndexPath:destinationIndexPath]; +} + +#pragma mark - UICollectionViewDelegate + +- (void)collectionView:(UICollectionView *)collectionView didSelectItemAtIndexPath:(NSIndexPath *)indexPath { + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:didSelectItemAtIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView didSelectItemAtIndexPath:indexPath]; + } + + IGListSectionController * sectionController = [self sectionControllerForSection:indexPath.section]; + [sectionController didSelectItemAtIndex:indexPath.item]; +} + +- (void)collectionView:(UICollectionView *)collectionView didDeselectItemAtIndexPath:(NSIndexPath *)indexPath { + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:didDeselectItemAtIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView didDeselectItemAtIndexPath:indexPath]; + } + + IGListSectionController * sectionController = [self sectionControllerForSection:indexPath.section]; + [sectionController didDeselectItemAtIndex:indexPath.item]; +} + +- (void)collectionView:(UICollectionView *)collectionView willDisplayCell:(UICollectionViewCell *)cell forItemAtIndexPath:(NSIndexPath *)indexPath { + id performanceDelegate = self.performanceDelegate; + [performanceDelegate listAdapterWillCallDisplayCell:self]; + + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:willDisplayCell:forItemAtIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView willDisplayCell:cell forItemAtIndexPath:indexPath]; + } + + IGListSectionController *sectionController = [self sectionControllerForView:cell]; + // if the section controller relationship was destroyed, reconnect it + // this happens with iOS 10 UICollectionView display range changes + if (sectionController == nil) { + sectionController = [self sectionControllerForSection:indexPath.section]; + [self mapView:cell toSectionController:sectionController]; + } + + id object = [self.sectionMap objectForSection:indexPath.section]; + [self.displayHandler willDisplayCell:cell forListAdapter:self sectionController:sectionController object:object indexPath:indexPath]; + + _isSendingWorkingRangeDisplayUpdates = YES; + [self.workingRangeHandler willDisplayItemAtIndexPath:indexPath forListAdapter:self]; + _isSendingWorkingRangeDisplayUpdates = NO; + + [performanceDelegate listAdapter:self didCallDisplayCell:cell onSectionController:sectionController atIndex:indexPath.item]; +} + +- (void)collectionView:(UICollectionView *)collectionView didEndDisplayingCell:(UICollectionViewCell *)cell forItemAtIndexPath:(NSIndexPath *)indexPath { + id performanceDelegate = self.performanceDelegate; + [performanceDelegate listAdapterWillCallEndDisplayCell:self]; + + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:didEndDisplayingCell:forItemAtIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView didEndDisplayingCell:cell forItemAtIndexPath:indexPath]; + } + + IGListSectionController *sectionController = [self sectionControllerForView:cell]; + [self.displayHandler didEndDisplayingCell:cell forListAdapter:self sectionController:sectionController indexPath:indexPath]; + [self.workingRangeHandler didEndDisplayingItemAtIndexPath:indexPath forListAdapter:self]; + + // break the association between the cell and the section controller + [self removeMapForView:cell]; + + [performanceDelegate listAdapter:self didCallEndDisplayCell:cell onSectionController:sectionController atIndex:indexPath.item]; +} + +- (void)collectionView:(UICollectionView *)collectionView willDisplaySupplementaryView:(UICollectionReusableView *)view forElementKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath { + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:willDisplaySupplementaryView:forElementKind:atIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView willDisplaySupplementaryView:view forElementKind:elementKind atIndexPath:indexPath]; + } + + IGListSectionController *sectionController = [self sectionControllerForView:view]; + // if the section controller relationship was destroyed, reconnect it + // this happens with iOS 10 UICollectionView display range changes + if (sectionController == nil) { + sectionController = [self.sectionMap sectionControllerForSection:indexPath.section]; + [self mapView:view toSectionController:sectionController]; + } + + id object = [self.sectionMap objectForSection:indexPath.section]; + [self.displayHandler willDisplaySupplementaryView:view forListAdapter:self sectionController:sectionController object:object indexPath:indexPath]; +} + +- (void)collectionView:(UICollectionView *)collectionView didEndDisplayingSupplementaryView:(UICollectionReusableView *)view forElementOfKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath { + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:didEndDisplayingSupplementaryView:forElementOfKind:atIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView didEndDisplayingSupplementaryView:view forElementOfKind:elementKind atIndexPath:indexPath]; + } + + IGListSectionController *sectionController = [self sectionControllerForView:view]; + [self.displayHandler didEndDisplayingSupplementaryView:view forListAdapter:self sectionController:sectionController indexPath:indexPath]; + + [self removeMapForView:view]; +} + +- (void)collectionView:(UICollectionView *)collectionView didHighlightItemAtIndexPath:(NSIndexPath *)indexPath { + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:didHighlightItemAtIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView didHighlightItemAtIndexPath:indexPath]; + } + + IGListSectionController * sectionController = [self sectionControllerForSection:indexPath.section]; + [sectionController didHighlightItemAtIndex:indexPath.item]; +} + +- (void)collectionView:(UICollectionView *)collectionView didUnhighlightItemAtIndexPath:(NSIndexPath *)indexPath { + // forward this method to the delegate b/c this implementation will steal the message from the proxy + id collectionViewDelegate = self.collectionViewDelegate; + if ([collectionViewDelegate respondsToSelector:@selector(collectionView:didUnhighlightItemAtIndexPath:)]) { + [collectionViewDelegate collectionView:collectionView didUnhighlightItemAtIndexPath:indexPath]; + } + + IGListSectionController * sectionController = [self sectionControllerForSection:indexPath.section]; + [sectionController didUnhighlightItemAtIndex:indexPath.item]; +} + +#pragma mark - UICollectionViewDelegateFlowLayout + +- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout sizeForItemAtIndexPath:(NSIndexPath *)indexPath { + IGAssert(![self.collectionViewDelegate respondsToSelector:_cmd], @"IGListAdapter is consuming method also implemented by the collectionViewDelegate: %@", NSStringFromSelector(_cmd)); + + CGSize size = [self sizeForItemAtIndexPath:indexPath]; + IGAssert(!isnan(size.height), @"IGListAdapter returned NaN height = %f for item at indexPath <%@>", size.height, indexPath); + IGAssert(!isnan(size.width), @"IGListAdapter returned NaN width = %f for item at indexPath <%@>", size.width, indexPath); + + return size; +} + +- (UIEdgeInsets)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout insetForSectionAtIndex:(NSInteger)section { + IGAssert(![self.collectionViewDelegate respondsToSelector:_cmd], @"IGListAdapter is consuming method also implemented by the collectionViewDelegate: %@", NSStringFromSelector(_cmd)); + return [[self sectionControllerForSection:section] inset]; +} + +- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout minimumLineSpacingForSectionAtIndex:(NSInteger)section { + IGAssert(![self.collectionViewDelegate respondsToSelector:_cmd], @"IGListAdapter is consuming method also implemented by the collectionViewDelegate: %@", NSStringFromSelector(_cmd)); + return [[self sectionControllerForSection:section] minimumLineSpacing]; +} + +- (CGFloat)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout minimumInteritemSpacingForSectionAtIndex:(NSInteger)section { + IGAssert(![self.collectionViewDelegate respondsToSelector:_cmd], @"IGListAdapter is consuming method also implemented by the collectionViewDelegate: %@", NSStringFromSelector(_cmd)); + return [[self sectionControllerForSection:section] minimumInteritemSpacing]; +} + +- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout *)collectionViewLayout referenceSizeForHeaderInSection:(NSInteger)section { + IGAssert(![self.collectionViewDelegate respondsToSelector:_cmd], @"IGListAdapter is consuming method also implemented by the collectionViewDelegate: %@", NSStringFromSelector(_cmd)); + NSIndexPath *indexPath = [NSIndexPath indexPathForItem:0 inSection:section]; + return [self sizeForSupplementaryViewOfKind:UICollectionElementKindSectionHeader atIndexPath:indexPath]; +} + +- (CGSize)collectionView:(UICollectionView *)collectionView layout:(UICollectionViewLayout*)collectionViewLayout referenceSizeForFooterInSection:(NSInteger)section { + IGAssert(![self.collectionViewDelegate respondsToSelector:_cmd], @"IGListAdapter is consuming method also implemented by the collectionViewDelegate: %@", NSStringFromSelector(_cmd)); + NSIndexPath *indexPath = [NSIndexPath indexPathForItem:0 inSection:section]; + return [self sizeForSupplementaryViewOfKind:UICollectionElementKindSectionFooter atIndexPath:indexPath]; +} + +#pragma mark - IGListCollectionViewDelegateLayout + +- (UICollectionViewLayoutAttributes *)collectionView:(UICollectionView *)collectionView + layout:(UICollectionViewLayout*)collectionViewLayout + customizedInitialLayoutAttributes:(UICollectionViewLayoutAttributes *)attributes + atIndexPath:(NSIndexPath *)indexPath { + IGListSectionController *sectionController = [self sectionControllerForSection:indexPath.section]; + if (sectionController.transitionDelegate) { + return [sectionController.transitionDelegate listAdapter:self + customizedInitialLayoutAttributes:attributes + sectionController:sectionController + atIndex:indexPath.item]; + } + return attributes; +} + +- (UICollectionViewLayoutAttributes *)collectionView:(UICollectionView *)collectionView + layout:(UICollectionViewLayout*)collectionViewLayout + customizedFinalLayoutAttributes:(UICollectionViewLayoutAttributes *)attributes + atIndexPath:(NSIndexPath *)indexPath { + IGListSectionController *sectionController = [self sectionControllerForSection:indexPath.section]; + if (sectionController.transitionDelegate) { + return [sectionController.transitionDelegate listAdapter:self + customizedFinalLayoutAttributes:attributes + sectionController:sectionController + atIndex:indexPath.item]; + } + return attributes; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterInternal.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterInternal.h new file mode 100644 index 0000000..08fe1c5 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterInternal.h @@ -0,0 +1,84 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import +#import +#import + +#import "IGListAdapter+UICollectionView.h" +#import "IGListAdapterProxy.h" +#import "IGListDisplayHandler.h" +#import "IGListSectionMap.h" +#import "IGListWorkingRangeHandler.h" + +NS_ASSUME_NONNULL_BEGIN + +/// Generate a string representation of a reusable view class when registering with a UICollectionView. +NS_INLINE NSString *IGListReusableViewIdentifier(Class viewClass, NSString * _Nullable kind, NSString * _Nullable givenReuseIdentifier) { + return [NSString stringWithFormat:@"%@%@%@", kind ?: @"", givenReuseIdentifier ?: @"", NSStringFromClass(viewClass)]; +} + +@interface IGListAdapter () +< +IGListCollectionContext, +IGListBatchContext +> +{ + __weak UICollectionView *_collectionView; + BOOL _isDequeuingCell; + BOOL _isSendingWorkingRangeDisplayUpdates; +} + +@property (nonatomic, strong) id updater; + +@property (nonatomic, strong, readonly) IGListSectionMap *sectionMap; +@property (nonatomic, strong, readonly) IGListDisplayHandler *displayHandler; +@property (nonatomic, strong, readonly) IGListWorkingRangeHandler *workingRangeHandler; + +@property (nonatomic, strong, nullable) IGListAdapterProxy *delegateProxy; + +@property (nonatomic, strong, nullable) UIView *emptyBackgroundView; + +// we need to special case interactive section moves that are moved to the last position +@property (nonatomic) BOOL isLastInteractiveMoveToLastSectionIndex; + +/** + When making object updates inside a batch update block, delete operations must use the section /before/ any moves take + place. This includes when other objects are deleted or inserted ahead of the section controller making the mutations. + In order to account for this we must track when the adapter is in the middle of an update block as well as the section + controller mapping prior to the transition. + + Note that the previous section controller map is destroyed as soon as a transition is finished so there is no dangling + objects or section controllers. + */ +@property (nonatomic, assign) BOOL isInUpdateBlock; +@property (nonatomic, strong, nullable) IGListSectionMap *previousSectionMap; + +/** + Set of cell identifiers registered with the list context. + Identifiers are constructed with the `IGListReusableViewIdentifier` function. + */ +@property (nonatomic, strong) NSMutableSet *registeredCellIdentifiers; +@property (nonatomic, strong) NSMutableSet *registeredNibNames; +@property (nonatomic, strong) NSMutableSet *registeredSupplementaryViewIdentifiers; +@property (nonatomic, strong) NSMutableSet *registeredSupplementaryViewNibNames; + +- (void)mapView:(__kindof UIView *)view toSectionController:(IGListSectionController *)sectionController; +- (nullable IGListSectionController *)sectionControllerForView:(__kindof UIView *)view; +- (void)removeMapForView:(__kindof UIView *)view; + +- (NSArray *)indexPathsFromSectionController:(IGListSectionController *)sectionController + indexes:(NSIndexSet *)indexes + usePreviousIfInUpdateBlock:(BOOL)usePreviousIfInUpdateBlock; + +- (nullable NSIndexPath *)indexPathForSectionController:(IGListSectionController *)controller + index:(NSInteger)index + usePreviousIfInUpdateBlock:(BOOL)usePreviousIfInUpdateBlock; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterProxy.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterProxy.h new file mode 100644 index 0000000..8122391 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterProxy.h @@ -0,0 +1,48 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +@class IGListAdapter; + +NS_ASSUME_NONNULL_BEGIN + +/** + A proxy that sends a custom set of selectors to an IGListAdapter object and the rest to a UICollectionViewDelegate + target. + */ +IGLK_SUBCLASSING_RESTRICTED +@interface IGListAdapterProxy : NSProxy + +/** + Create a new proxy object with targets and interceptor. + + @param collectionViewTarget A UICollectionViewDelegate conforming object that receives non-intercepted messages. + @param scrollViewTarget A UIScrollViewDelegate conforming object that receives non-intercepted messages. + @param interceptor An IGListAdapter object that intercepts a set of messages. + + @return A new IGListAdapterProxy object. + */ +- (instancetype)initWithCollectionViewTarget:(nullable id)collectionViewTarget + scrollViewTarget:(nullable id)scrollViewTarget + interceptor:(IGListAdapter *)interceptor; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterProxy.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterProxy.m new file mode 100644 index 0000000..0884b2f --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterProxy.m @@ -0,0 +1,96 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListAdapterProxy.h" + +#import + +#import "IGListCollectionViewDelegateLayout.h" + +/** + Define messages that you want the IGListAdapter object to intercept. Pattern copied from + https://github.com/facebook/AsyncDisplayKit/blob/7b112a2dcd0391ddf3671f9dcb63521f554b78bd/AsyncDisplayKit/ASCollectionView.mm#L34-L53 + */ +static BOOL isInterceptedSelector(SEL sel) { + return ( + // UIScrollViewDelegate + sel == @selector(scrollViewDidScroll:) || + sel == @selector(scrollViewWillBeginDragging:) || + sel == @selector(scrollViewDidEndDragging:willDecelerate:) || + sel == @selector(scrollViewDidEndDecelerating:) || + // UICollectionViewDelegate + sel == @selector(collectionView:willDisplayCell:forItemAtIndexPath:) || + sel == @selector(collectionView:didEndDisplayingCell:forItemAtIndexPath:) || + sel == @selector(collectionView:didSelectItemAtIndexPath:) || + sel == @selector(collectionView:didDeselectItemAtIndexPath:) || + sel == @selector(collectionView:didHighlightItemAtIndexPath:) || + sel == @selector(collectionView:didUnhighlightItemAtIndexPath:) || + // UICollectionViewDelegateFlowLayout + sel == @selector(collectionView:layout:sizeForItemAtIndexPath:) || + sel == @selector(collectionView:layout:insetForSectionAtIndex:) || + sel == @selector(collectionView:layout:minimumInteritemSpacingForSectionAtIndex:) || + sel == @selector(collectionView:layout:minimumLineSpacingForSectionAtIndex:) || + sel == @selector(collectionView:layout:referenceSizeForFooterInSection:) || + sel == @selector(collectionView:layout:referenceSizeForHeaderInSection:) || + + // IGListCollectionViewDelegateLayout + sel == @selector(collectionView:layout:customizedInitialLayoutAttributes:atIndexPath:) || + sel == @selector(collectionView:layout:customizedFinalLayoutAttributes:atIndexPath:) + ); +} + +@interface IGListAdapterProxy () { + __weak id _collectionViewTarget; + __weak id _scrollViewTarget; + __weak IGListAdapter *_interceptor; +} + +@end + +@implementation IGListAdapterProxy + +- (instancetype)initWithCollectionViewTarget:(nullable id)collectionViewTarget + scrollViewTarget:(nullable id)scrollViewTarget + interceptor:(IGListAdapter *)interceptor { + IGParameterAssert(interceptor != nil); + // -[NSProxy init] is undefined + if (self) { + _collectionViewTarget = collectionViewTarget; + _scrollViewTarget = scrollViewTarget; + _interceptor = interceptor; + } + return self; +} + +- (BOOL)respondsToSelector:(SEL)aSelector { + return isInterceptedSelector(aSelector) + || [_collectionViewTarget respondsToSelector:aSelector] + || [_scrollViewTarget respondsToSelector:aSelector]; +} + +- (id)forwardingTargetForSelector:(SEL)aSelector { + if (isInterceptedSelector(aSelector)) { + return _interceptor; + } + + // since UICollectionViewDelegate is a superset of UIScrollViewDelegate, first check if the method exists in + // _scrollViewTarget, otherwise use the _collectionViewTarget + return [_scrollViewTarget respondsToSelector:aSelector] ? _scrollViewTarget : _collectionViewTarget; +} + +// handling unimplemented methods and nil target/interceptor +// https://github.com/Flipboard/FLAnimatedImage/blob/76a31aefc645cc09463a62d42c02954a30434d7d/FLAnimatedImage/FLAnimatedImage.m#L786-L807 +- (void)forwardInvocation:(NSInvocation *)invocation { + void *nullPointer = NULL; + [invocation setReturnValue:&nullPointer]; +} + +- (NSMethodSignature *)methodSignatureForSelector:(SEL)selector { + return [NSObject instanceMethodSignatureForSelector:@selector(init)]; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.h new file mode 100644 index 0000000..b7ee299 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@interface IGListAdapterUpdater (DebugDescription) + +- (NSArray *)debugDescriptionLines; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.m new file mode 100644 index 0000000..809561a --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.m @@ -0,0 +1,75 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListAdapterUpdater+DebugDescription.h" + +#import "IGListAdapterUpdaterInternal.h" +#import "IGListBatchUpdateData+DebugDescription.h" +#import "IGListDebuggingUtilities.h" + +#if IGLK_DEBUG_DESCRIPTION_ENABLED +static NSMutableArray *linesFromObjects(NSArray *objects) { + NSMutableArray *lines = [NSMutableArray new]; + for (id object in objects) { + [lines addObject:[NSString stringWithFormat:@"Object %p of type %@ with identifier %@", + object, NSStringFromClass([object class]), [object diffIdentifier]]]; + } + return lines; +} +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED + +@implementation IGListAdapterUpdater (DebugDescription) + +- (NSArray *)debugDescriptionLines { + NSMutableArray *debug = [NSMutableArray new]; +#if IGLK_DEBUG_DESCRIPTION_ENABLED + [debug addObject:[NSString stringWithFormat:@"Moves as deletes+inserts: %@", IGListDebugBOOL(self.movesAsDeletesInserts)]]; + [debug addObject:[NSString stringWithFormat:@"Allows background reloading: %@", IGListDebugBOOL(self.allowsBackgroundReloading)]]; + [debug addObject:[NSString stringWithFormat:@"Has queued reload data: %@", IGListDebugBOOL(self.hasQueuedReloadData)]]; + [debug addObject:[NSString stringWithFormat:@"Queued update is animated: %@", IGListDebugBOOL(self.queuedUpdateIsAnimated)]]; + + NSString *stateString; + switch (self.state) { + case IGListBatchUpdateStateIdle: + stateString = @"Idle"; + break; + case IGListBatchUpdateStateQueuedBatchUpdate: + stateString = @"Queued batch update"; + break; + case IGListBatchUpdateStateExecutedBatchUpdateBlock: + stateString = @"Executed batch update block"; + break; + case IGListBatchUpdateStateExecutingBatchUpdateBlock: + stateString = @"Executing batch update block"; + break; + } + [debug addObject:[NSString stringWithFormat:@"State: %@", stateString]]; + + if (self.applyingUpdateData != nil) { + [debug addObject:@"Batch update data:"]; + [debug addObjectsFromArray:IGListDebugIndentedLines([self.applyingUpdateData debugDescriptionLines])]; + } + + if (self.fromObjects != nil) { + [debug addObject:@"From objects:"]; + [debug addObjectsFromArray:IGListDebugIndentedLines(linesFromObjects(self.fromObjects))]; + } + + if (self.toObjectsBlock != nil) { + [debug addObject:@"To objects:"]; + [debug addObjectsFromArray:IGListDebugIndentedLines(linesFromObjects(self.toObjectsBlock()))]; + } + + if (self.pendingTransitionToObjects != nil) { + [debug addObject:@"Pending objects:"]; + [debug addObjectsFromArray:IGListDebugIndentedLines(linesFromObjects(self.pendingTransitionToObjects))]; + } +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED + return debug; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdaterInternal.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdaterInternal.h new file mode 100644 index 0000000..df02271 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListAdapterUpdaterInternal.h @@ -0,0 +1,51 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import +#import + +#import + +#import "IGListAdapterUpdater.h" +#import "IGListBatchUpdateState.h" +#import "IGListBatchUpdates.h" + +NS_ASSUME_NONNULL_BEGIN + +FOUNDATION_EXTERN void convertReloadToDeleteInsert(NSMutableIndexSet *reloads, + NSMutableIndexSet *deletes, + NSMutableIndexSet *inserts, + IGListIndexSetResult *result, + NSArray> *fromObjects); + +@interface IGListAdapterUpdater () + +@property (nonatomic, copy, nullable) NSArray *fromObjects; +@property (nonatomic, copy, nullable) IGListToObjectBlock toObjectsBlock; +@property (nonatomic, copy, nullable) NSArray *pendingTransitionToObjects; +@property (nonatomic, strong) NSMutableArray *completionBlocks; + +@property (nonatomic, assign) BOOL queuedUpdateIsAnimated; + +@property (nonatomic, strong) IGListBatchUpdates *batchUpdates; + +@property (nonatomic, copy, nullable) IGListObjectTransitionBlock objectTransitionBlock; + +@property (nonatomic, copy, nullable) IGListReloadUpdateBlock reloadUpdates; +@property (nonatomic, assign, getter=hasQueuedReloadData) BOOL queuedReloadData; + +@property (nonatomic, assign) IGListBatchUpdateState state; +@property (nonatomic, strong, nullable) IGListBatchUpdateData *applyingUpdateData; + +- (void)performReloadDataWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock; +- (void)performBatchUpdatesWithCollectionViewBlock:(IGListCollectionViewBlock)collectionViewBlock; +- (void)cleanStateBeforeUpdates; +- (BOOL)hasChanges; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListArrayUtilsInternal.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListArrayUtilsInternal.h new file mode 100644 index 0000000..f3025b0 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListArrayUtilsInternal.h @@ -0,0 +1,34 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#ifndef IGListArrayUtilsInternal_h +#define IGListArrayUtilsInternal_h + +#import + +static NSArray *objectsWithDuplicateIdentifiersRemoved(NSArray> *objects) { + if (objects == nil) { + return nil; + } + + NSMapTable *identifierMap = [NSMapTable strongToStrongObjectsMapTable]; + NSMutableArray *uniqueObjects = [NSMutableArray new]; + for (id object in objects) { + id diffIdentifier = [object diffIdentifier]; + id previousObject = [identifierMap objectForKey:diffIdentifier]; + if (diffIdentifier != nil + && previousObject == nil) { + [identifierMap setObject:object forKey:diffIdentifier]; + [uniqueObjects addObject:object]; + } else { + IGLKLog(@"Duplicate identifier %@ for object %@ with object %@", diffIdentifier, object, previousObject); + } + } + return uniqueObjects; +} + +#endif /* IGListArrayUtilsInternal_h */ diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.h new file mode 100644 index 0000000..095e221 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@interface IGListBatchUpdateData (DebugDescription) + +- (NSArray *)debugDescriptionLines; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.m new file mode 100644 index 0000000..652529c --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.m @@ -0,0 +1,38 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListBatchUpdateData+DebugDescription.h" + +@implementation IGListBatchUpdateData (DebugDescription) + +- (NSArray *)debugDescriptionLines { + NSMutableArray *debug = [NSMutableArray new]; +#if IGLK_DEBUG_DESCRIPTION_ENABLED + [debug addObject:[NSString stringWithFormat:@"Insert sections: %@", self.insertSections]]; + [debug addObject:[NSString stringWithFormat:@"Delete sections: %@", self.deleteSections]]; + + for (IGListMoveIndex *move in self.moveSections) { + [debug addObject:[NSString stringWithFormat:@"Move from section %li to %li", (long)move.from, (long)move.to]]; + } + + for (NSIndexPath *path in self.deleteIndexPaths) { + [debug addObject:[NSString stringWithFormat:@"Delete section %li item %li", (long)path.section, (long)path.item]]; + } + + for (NSIndexPath *path in self.insertIndexPaths) { + [debug addObject:[NSString stringWithFormat:@"Insert section %li item %li", (long)path.section, (long)path.item]]; + } + + for (IGListMoveIndexPath *move in self.moveIndexPaths) { + [debug addObject:[NSString stringWithFormat:@"Move from section %li item %li to section %li item %li", + (long)move.from.section, (long)move.from.item, (long)move.to.section, (long)move.to.item]]; + } +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED + return debug; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateState.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateState.h new file mode 100644 index 0000000..00fd977 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdateState.h @@ -0,0 +1,15 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +typedef NS_ENUM (NSInteger, IGListBatchUpdateState) { + IGListBatchUpdateStateIdle, + IGListBatchUpdateStateQueuedBatchUpdate, + IGListBatchUpdateStateExecutingBatchUpdateBlock, + IGListBatchUpdateStateExecutedBatchUpdateBlock, +}; diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdates.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdates.h new file mode 100644 index 0000000..263341d --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdates.h @@ -0,0 +1,29 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +@class IGListMoveIndexPath; +@class IGListReloadIndexPath; + +IGLK_SUBCLASSING_RESTRICTED +@interface IGListBatchUpdates : NSObject + +@property (nonatomic, strong, readonly) NSMutableIndexSet *sectionReloads; +@property (nonatomic, strong, readonly) NSMutableArray *itemInserts; +@property (nonatomic, strong, readonly) NSMutableArray *itemDeletes; +@property (nonatomic, strong, readonly) NSMutableArray *itemReloads; +@property (nonatomic, strong, readonly) NSMutableArray *itemMoves; + +@property (nonatomic, strong, readonly) NSMutableArray *itemUpdateBlocks; +@property (nonatomic, strong, readonly) NSMutableArray *itemCompletionBlocks; + +- (BOOL)hasChanges; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdates.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdates.m new file mode 100644 index 0000000..25aeb53 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBatchUpdates.m @@ -0,0 +1,34 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListBatchUpdates.h" + +@implementation IGListBatchUpdates + +- (instancetype)init { + if (self = [super init]) { + _sectionReloads = [NSMutableIndexSet new]; + _itemInserts = [NSMutableArray new]; + _itemMoves = [NSMutableArray new]; + _itemDeletes = [NSMutableArray new]; + _itemReloads = [NSMutableArray new]; + _itemUpdateBlocks = [NSMutableArray new]; + _itemCompletionBlocks = [NSMutableArray new]; + } + return self; +} + +- (BOOL)hasChanges { + return [self.itemUpdateBlocks count] > 0 + || [self.sectionReloads count] > 0 + || [self.itemInserts count] > 0 + || [self.itemMoves count] > 0 + || [self.itemReloads count] > 0 + || [self.itemDeletes count] > 0; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.h new file mode 100644 index 0000000..f49a8d3 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@interface IGListBindingSectionController (DebugDescription) + +- (NSArray *)debugDescriptionLines; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.m new file mode 100644 index 0000000..48711aa --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.m @@ -0,0 +1,46 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListBindingSectionController+DebugDescription.h" + +#import "IGListDebuggingUtilities.h" + +@implementation IGListBindingSectionController (DebugDescription) + +- (NSString *)debugDescription { + NSMutableArray *lines = [NSMutableArray arrayWithObject:[NSString stringWithFormat:@"IGListBindingSectionController %p:", self]]; + [lines addObjectsFromArray:IGListDebugIndentedLines([self debugDescriptionLines])]; + return [lines componentsJoinedByString:@"\n"]; +} + +- (NSArray *)debugDescriptionLines { + NSMutableArray *debug = [NSMutableArray new]; +#if IGLK_DEBUG_DESCRIPTION_ENABLED + [debug addObject:[NSString stringWithFormat:@"Data source: %@", self.dataSource]]; + [debug addObject:[NSString stringWithFormat:@"Selection delegate: %@", self.selectionDelegate]]; + [debug addObject:[NSString stringWithFormat:@"Object: %@", self.object]]; + [debug addObject:@"View models:"]; + for (id viewModel in self.viewModels) { + [debug addObject:[NSString stringWithFormat:@"%@: %@", viewModel, viewModel.diffIdentifier]]; + } + [debug addObject:[NSString stringWithFormat:@"Number of items: %ld", (long)self.numberOfItems]]; + [debug addObject:[NSString stringWithFormat:@"View controller: %@", self.viewController]]; + [debug addObject:[NSString stringWithFormat:@"Collection context: %@", self.collectionContext]]; + [debug addObject:[NSString stringWithFormat:@"Section: %ld", (long)self.section]]; + [debug addObject:[NSString stringWithFormat:@"Is first section: %@", IGListDebugBOOL(self.isFirstSection)]]; + [debug addObject:[NSString stringWithFormat:@"Is last section: %@", IGListDebugBOOL(self.isLastSection)]]; + [debug addObject:[NSString stringWithFormat:@"Supplementary view source: %@", self.supplementaryViewSource]]; + [debug addObject:[NSString stringWithFormat:@"Display delegate: %@", self.displayDelegate]]; + [debug addObject:[NSString stringWithFormat:@"Working range delegate: %@", self.workingRangeDelegate]]; + [debug addObject:[NSString stringWithFormat:@"Scroll delegate: %@", self.scrollDelegate]]; + +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED + return debug; +} + +@end + diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListCollectionViewLayoutInternal.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListCollectionViewLayoutInternal.h new file mode 100644 index 0000000..4191bcb --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListCollectionViewLayoutInternal.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +static CGRect IGListRectIntegralScaled(CGRect rect) { + CGFloat scale = [[UIScreen mainScreen] scale]; + return CGRectMake(floorf(rect.origin.x * scale) / scale, + floorf(rect.origin.y * scale) / scale, + ceilf(rect.size.width * scale) / scale, + ceilf(rect.size.height * scale) / scale); +} diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebugger.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebugger.h new file mode 100644 index 0000000..b917acb --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebugger.h @@ -0,0 +1,28 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +@class IGListAdapter; + +IGLK_SUBCLASSING_RESTRICTED +@interface IGListDebugger : NSObject + ++ (void)trackAdapter:(IGListAdapter *)adapter; + ++ (NSArray *)adapterDescriptions; + ++ (void)clear; + ++ (NSString *)dump; + +- (instancetype)init NS_UNAVAILABLE; ++ (instancetype)new NS_UNAVAILABLE; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebugger.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebugger.m new file mode 100644 index 0000000..bb55efd --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebugger.m @@ -0,0 +1,41 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListDebugger.h" + +#import "IGListAdapter+DebugDescription.h" + +@implementation IGListDebugger + +static NSHashTable *livingAdaptersTable = nil; + ++ (void)trackAdapter:(IGListAdapter *)adapter { +#if IGLK_DEBUG_DESCRIPTION_ENABLED + if (livingAdaptersTable == nil) { + livingAdaptersTable = [NSHashTable weakObjectsHashTable]; + } + [livingAdaptersTable addObject:adapter]; +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED +} + ++ (NSArray *)adapterDescriptions { + NSMutableArray *descriptions = [NSMutableArray new]; + for (IGListAdapter *adapter in livingAdaptersTable) { + [descriptions addObject:[adapter debugDescription]]; + } + return descriptions; +} + ++ (void)clear { + [livingAdaptersTable removeAllObjects]; +} + ++ (NSString *)dump { + return [[self adapterDescriptions] componentsJoinedByString:@"\n"]; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebuggingUtilities.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebuggingUtilities.h new file mode 100644 index 0000000..5edfb4c --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebuggingUtilities.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; + +extern NSString *IGListDebugBOOL(BOOL b); + +extern NSArray *IGListDebugIndentedLines(NSArray *lines); diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebuggingUtilities.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebuggingUtilities.m new file mode 100644 index 0000000..f4deb0d --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDebuggingUtilities.m @@ -0,0 +1,20 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListDebuggingUtilities.h" + +NSString *IGListDebugBOOL(BOOL b) { + return b ? @"Yes" : @"No"; +} + +NSArray *IGListDebugIndentedLines(NSArray *lines) { + NSMutableArray *newLines = [NSMutableArray new]; + for (NSString *line in lines) { + [newLines addObject:[NSString stringWithFormat:@" %@", line]]; + } + return newLines; +} diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDisplayHandler.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDisplayHandler.h new file mode 100644 index 0000000..d7ec4fb --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDisplayHandler.h @@ -0,0 +1,87 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +@class IGListAdapter; +@class IGListSectionController; + + + +NS_ASSUME_NONNULL_BEGIN + +IGLK_SUBCLASSING_RESTRICTED +@interface IGListDisplayHandler : NSObject + +/** + Counted set of the currently visible section controllers. + */ +@property (nonatomic, strong, readonly) NSCountedSet *visibleListSections; + +/** + Tells the handler that a cell will be displayed in the IGListAdapter. + + @param cell A cell that will be displayed. + @param listAdapter The adapter the cell will display in. + @param sectionController The section controller that manages the cell. + @param object The object that powers the section controller. + @param indexPath The index path of the cell in the UICollectionView. + */ +- (void)willDisplayCell:(UICollectionViewCell *)cell + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + object:(id)object + indexPath:(NSIndexPath *)indexPath; + +/** + Tells the handler that a cell did end display in the IGListAdapter. + + @param cell A cell that will be displayed. + @param listAdapter The adapter the cell will display in. + @param sectionController The section controller that manages the cell. + @param indexPath The index path of the cell in the UICollectionView. + */ +- (void)didEndDisplayingCell:(UICollectionViewCell *)cell + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + indexPath:(NSIndexPath *)indexPath; + + +/** + Tells the handler that a supplementary view will be displayed in the IGListAdapter. + + @param view A supplementary view that will be displayed. + @param listAdapter The adapter the supplementary view will display in. + @param sectionController The section controller that manages the supplementary view. + @param object The object that powers the section controller. + @param indexPath The index path of the supplementary view in the UICollectionView. + */ +- (void)willDisplaySupplementaryView:(UICollectionReusableView *)view + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + object:(id)object + indexPath:(NSIndexPath *)indexPath; + + +/** + Tells the handler that a supplementary view did end display in the IGListAdapter. + + @param view A supplementary view that will be displayed. + @param listAdapter The adapter the supplementary view will display in. + @param sectionController The section controller that manages the supplementary view. + @param indexPath The index path of the supplementary view in the UICollectionView. + */ +- (void)didEndDisplayingSupplementaryView:(UICollectionReusableView *)view + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + indexPath:(NSIndexPath *)indexPath; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDisplayHandler.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDisplayHandler.m new file mode 100644 index 0000000..ee28942 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListDisplayHandler.m @@ -0,0 +1,122 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListDisplayHandler.h" + +#import +#import +#import +#import + +@interface IGListDisplayHandler () + +@property (nonatomic, strong) NSMapTable *visibleViewObjectMap; + +@end + +@implementation IGListDisplayHandler + +- (instancetype)init { + if (self = [super init]) { + _visibleListSections = [NSCountedSet new]; + _visibleViewObjectMap = [[NSMapTable alloc] initWithKeyOptions:NSMapTableStrongMemory valueOptions:NSMapTableStrongMemory capacity:0]; + } + return self; +} + +- (id)_pluckObjectForView:(UICollectionReusableView *)view { + NSMapTable *viewObjectMap = self.visibleViewObjectMap; + id object = [viewObjectMap objectForKey:view]; + [viewObjectMap removeObjectForKey:view]; + return object; +} + +- (void)_willDisplayReusableView:(UICollectionReusableView *)view + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + object:(id)object + indexPath:(NSIndexPath *)indexPath { + IGParameterAssert(view != nil); + IGParameterAssert(listAdapter != nil); + IGParameterAssert(object != nil); + IGParameterAssert(indexPath != nil); + + [self.visibleViewObjectMap setObject:object forKey:view]; + NSCountedSet *visibleListSections = self.visibleListSections; + if ([visibleListSections countForObject:sectionController] == 0) { + [sectionController.displayDelegate listAdapter:listAdapter willDisplaySectionController:sectionController]; + [listAdapter.delegate listAdapter:listAdapter willDisplayObject:object atIndex:indexPath.section]; + } + [visibleListSections addObject:sectionController]; +} + +- (void)_didEndDisplayingReusableView:(UICollectionReusableView *)view + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + object:(id)object + indexPath:(NSIndexPath *)indexPath { + IGParameterAssert(view != nil); + IGParameterAssert(listAdapter != nil); + IGParameterAssert(indexPath != nil); + + if (object == nil || sectionController == nil) { + return; + } + + const NSInteger section = indexPath.section; + + NSCountedSet *visibleSections = self.visibleListSections; + [visibleSections removeObject:sectionController]; + + if ([visibleSections countForObject:sectionController] == 0) { + [sectionController.displayDelegate listAdapter:listAdapter didEndDisplayingSectionController:sectionController]; + [listAdapter.delegate listAdapter:listAdapter didEndDisplayingObject:object atIndex:section]; + } +} + +- (void)willDisplaySupplementaryView:(UICollectionReusableView *)view + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + object:(id)object + indexPath:(NSIndexPath *)indexPath { + [self _willDisplayReusableView:view forListAdapter:listAdapter sectionController:sectionController object:object indexPath:indexPath]; +} + +- (void)didEndDisplayingSupplementaryView:(UICollectionReusableView *)view + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + indexPath:(NSIndexPath *)indexPath { + // if cell display events break, don't send display events when the object has disappeared + id object = [self _pluckObjectForView:view]; + [self _didEndDisplayingReusableView:view forListAdapter:listAdapter sectionController:sectionController object:object indexPath:indexPath]; +} + +- (void)willDisplayCell:(UICollectionViewCell *)cell + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + object:(id)object + indexPath:(NSIndexPath *)indexPath { + id displayDelegate = [sectionController displayDelegate]; + [displayDelegate listAdapter:listAdapter willDisplaySectionController:sectionController cell:cell atIndex:indexPath.item]; + [self _willDisplayReusableView:cell forListAdapter:listAdapter sectionController:sectionController object:object indexPath:indexPath]; +} + +- (void)didEndDisplayingCell:(UICollectionViewCell *)cell + forListAdapter:(IGListAdapter *)listAdapter + sectionController:(IGListSectionController *)sectionController + indexPath:(NSIndexPath *)indexPath { + // if cell display events break, don't send cell events to the displayDelegate when the object has disappeared + id object = [self _pluckObjectForView:cell]; + if (object == nil) { + return; + } + + [sectionController.displayDelegate listAdapter:listAdapter didEndDisplayingSectionController:sectionController cell:cell atIndex:indexPath.item]; + [self _didEndDisplayingReusableView:cell forListAdapter:listAdapter sectionController:sectionController object:object indexPath:indexPath]; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListReloadIndexPath.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListReloadIndexPath.h new file mode 100644 index 0000000..279b22e --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListReloadIndexPath.h @@ -0,0 +1,52 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +/** + An object with index path information for reloading an item during a batch update. + */ +IGLK_SUBCLASSING_RESTRICTED +@interface IGListReloadIndexPath : NSObject + +/** + The index path of the item before batch updates are applied. + */ +@property (nonatomic, strong, readonly) NSIndexPath *fromIndexPath; + +/** + The index path of the item after batch updates are applied. + */ +@property (nonatomic, strong, readonly) NSIndexPath *toIndexPath; + +/** + Creates a new reload object. + + @param fromIndexPath The index path of the item before batch updates. + @param toIndexPath The index path of the item after batch updates. + @return A new reload object. + */ +- (instancetype)initWithFromIndexPath:(NSIndexPath *)fromIndexPath + toIndexPath:(NSIndexPath *)toIndexPath NS_DESIGNATED_INITIALIZER; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListReloadIndexPath.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListReloadIndexPath.m new file mode 100644 index 0000000..4660a43 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListReloadIndexPath.m @@ -0,0 +1,21 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListReloadIndexPath.h" + +@implementation IGListReloadIndexPath + +- (instancetype)initWithFromIndexPath:(NSIndexPath *)fromIndexPath + toIndexPath:(NSIndexPath *)toIndexPath { + if (self = [super init]) { + _fromIndexPath = fromIndexPath; + _toIndexPath = toIndexPath; + } + return self; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionControllerInternal.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionControllerInternal.h new file mode 100644 index 0000000..40aa3e5 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionControllerInternal.h @@ -0,0 +1,31 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListSectionController.h" + +FOUNDATION_EXTERN void IGListSectionControllerPushThread(UIViewController *viewController, id collectionContext); + +FOUNDATION_EXTERN void IGListSectionControllerPopThread(void); + +@interface IGListSectionController() + +@property (nonatomic, weak, readwrite) id collectionContext; + +@property (nonatomic, weak, readwrite) UIViewController *viewController; + +@property (nonatomic, assign, readwrite) NSInteger section; + +@property (nonatomic, assign, readwrite) BOOL isFirstSection; + +@property (nonatomic, assign, readwrite) BOOL isLastSection; + +/* + Provides a way for specialized section controllers (like the stacked section controller) to reject invalid moves + */ +- (BOOL)canMoveItemAtIndex:(NSInteger)sourceItemIndex toIndex:(NSInteger)destinationItemIndex; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap+DebugDescription.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap+DebugDescription.h new file mode 100644 index 0000000..9f7207e --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap+DebugDescription.h @@ -0,0 +1,16 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import "IGListSectionMap.h" + +@interface IGListSectionMap (DebugDescription) + +- (NSArray *)debugDescriptionLines; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap+DebugDescription.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap+DebugDescription.m new file mode 100644 index 0000000..2df0984 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap+DebugDescription.m @@ -0,0 +1,30 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListSectionMap+DebugDescription.h" + +#import "IGListBindingSectionController.h" + +@implementation IGListSectionMap (DebugDescription) + +- (NSArray *)debugDescriptionLines { + NSMutableArray *debug = [NSMutableArray new]; +#if IGLK_DEBUG_DESCRIPTION_ENABLED + [self enumerateUsingBlock:^(id object, IGListSectionController *sectionController, NSInteger section, BOOL *stop) { + if ([sectionController isKindOfClass:[IGListBindingSectionController class]]) { + [debug addObject:[sectionController debugDescription]]; + } else { + [debug addObject:[NSString stringWithFormat:@"Object and section controller at section: %li:", (long)section]]; + [debug addObject:[NSString stringWithFormat:@" %@", object]]; + [debug addObject:[NSString stringWithFormat:@" %@", sectionController]]; + } + }]; +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED + return debug; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap.h new file mode 100644 index 0000000..1fd16aa --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap.h @@ -0,0 +1,115 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +@class IGListSectionController; + + +NS_ASSUME_NONNULL_BEGIN + +/** + The IGListSectionMap provides a way to map a collection of objects to a collection of section controllers and achieve + constant-time lookups O(1). + + IGListSectionMap is a mutable object and does not guarantee thread safety. + */ +IGLK_SUBCLASSING_RESTRICTED +@interface IGListSectionMap : NSObject + +- (instancetype)initWithMapTable:(NSMapTable *)mapTable NS_DESIGNATED_INITIALIZER; + +/** + The objects stored in the map. + */ +@property (nonatomic, strong, readonly) NSArray *objects; + +/** + Update the map with objects and the section controller counterparts. + + @param objects The objects in the collection. + @param sectionControllers The section controllers that map to each object. + */ +- (void)updateWithObjects:(NSArray > *)objects sectionControllers:(NSArray *)sectionControllers; + +/** + Fetch a section controller given a section. + + @param section The section index of the section controller. + + @return A section controller. + */ +- (nullable IGListSectionController *)sectionControllerForSection:(NSInteger)section; + +/** + Fetch the object for a section + + @param section The section index of the object. + + @return The object corresponding to the section. + */ +- (nullable id)objectForSection:(NSInteger)section; + +/** + Fetch a section controller given an object. Can return nil. + + @param object The object that maps to a section controller. + + @return A section controller. + */ +- (nullable id)sectionControllerForObject:(id)object; + +/** + Look up the section index for a section controller. + + @param sectionController The list to look up. + + @return The section index of the given section controller if it exists, NSNotFound otherwise. + */ +- (NSInteger)sectionForSectionController:(id)sectionController; + +/** + Look up the section index for an object. + + @param object The object to look up. + + @return The section index of the given object if it exists, NSNotFound otherwise. + */ +- (NSInteger)sectionForObject:(id)object; + +/** + Remove all saved objects and section controllers. + */ +- (void)reset; + +/** + Update an object with a new instance. + */ +- (void)updateObject:(id)object; + +/** + Applies a given block object to the entries of the section controller map. + + @param block A block object to operate on entries in the section controller map. + */ +- (void)enumerateUsingBlock:(void (^)(id object, IGListSectionController *sectionController, NSInteger section, BOOL *stop))block; + +/** + :nodoc: + */ +- (instancetype)init NS_UNAVAILABLE; + +/** + :nodoc: + */ ++ (instancetype)new NS_UNAVAILABLE; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap.m new file mode 100644 index 0000000..0b856e8 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListSectionMap.m @@ -0,0 +1,155 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListSectionMap.h" + +#import + +#import "IGListSectionControllerInternal.h" + +@interface IGListSectionMap () + +// both of these maps allow fast lookups of objects, list objects, and indexes +@property (nonatomic, strong, readonly, nonnull) NSMapTable *objectToSectionControllerMap; +@property (nonatomic, strong, readonly, nonnull) NSMapTable *sectionControllerToSectionMap; + +@property (nonatomic, strong, nonnull) NSMutableArray *mObjects; + +@end + +@implementation IGListSectionMap + +- (instancetype)initWithMapTable:(NSMapTable *)mapTable { + IGParameterAssert(mapTable != nil); + + if (self = [super init]) { + _objectToSectionControllerMap = [mapTable copy]; + + // lookup list objects by pointer equality + _sectionControllerToSectionMap = [[NSMapTable alloc] initWithKeyOptions:NSMapTableStrongMemory | NSMapTableObjectPointerPersonality + valueOptions:NSMapTableStrongMemory + capacity:0]; + _mObjects = [NSMutableArray new]; + } + return self; +} + + +#pragma mark - Public API + +- (NSArray *)objects { + return [self.mObjects copy]; +} + +- (NSInteger)sectionForSectionController:(IGListSectionController *)sectionController { + IGParameterAssert(sectionController != nil); + + NSNumber *index = [self.sectionControllerToSectionMap objectForKey:sectionController]; + return index != nil ? [index integerValue] : NSNotFound; +} + +- (IGListSectionController *)sectionControllerForSection:(NSInteger)section { + return [self.objectToSectionControllerMap objectForKey:[self objectForSection:section]]; +} + +- (void)updateWithObjects:(NSArray *)objects sectionControllers:(NSArray *)sectionControllers { + IGParameterAssert(objects.count == sectionControllers.count); + + [self reset]; + + self.mObjects = [objects mutableCopy]; + + id firstObject = objects.firstObject; + id lastObject = objects.lastObject; + + [objects enumerateObjectsUsingBlock:^(id object, NSUInteger idx, BOOL *stop) { + IGListSectionController *sectionController = sectionControllers[idx]; + + // set the index of the list for easy reverse lookup + [self.sectionControllerToSectionMap setObject:@(idx) forKey:sectionController]; + [self.objectToSectionControllerMap setObject:sectionController forKey:object]; + + sectionController.isFirstSection = (object == firstObject); + sectionController.isLastSection = (object == lastObject); + sectionController.section = (NSInteger)idx; + }]; +} + +- (nullable IGListSectionController *)sectionControllerForObject:(id)object { + IGParameterAssert(object != nil); + + return [self.objectToSectionControllerMap objectForKey:object]; +} + +- (nullable id)objectForSection:(NSInteger)section { + NSArray *objects = self.mObjects; + if (section < objects.count) { + return objects[section]; + } else { + return nil; + } +} + +- (NSInteger)sectionForObject:(id)object { + IGParameterAssert(object != nil); + + id sectionController = [self sectionControllerForObject:object]; + if (sectionController == nil) { + return NSNotFound; + } else { + return [self sectionForSectionController:sectionController]; + } +} + +- (void)reset { + [self enumerateUsingBlock:^(id _Nonnull object, IGListSectionController * _Nonnull sectionController, NSInteger section, BOOL * _Nonnull stop) { + sectionController.section = NSNotFound; + sectionController.isFirstSection = NO; + sectionController.isLastSection = NO; + }]; + + [self.sectionControllerToSectionMap removeAllObjects]; + [self.objectToSectionControllerMap removeAllObjects]; +} + +- (void)updateObject:(id)object { + IGParameterAssert(object != nil); + const NSInteger section = [self sectionForObject:object]; + id sectionController = [self sectionControllerForObject:object]; + [self.sectionControllerToSectionMap setObject:@(section) forKey:sectionController]; + [self.objectToSectionControllerMap setObject:sectionController forKey:object]; + self.mObjects[section] = object; +} + +- (void)enumerateUsingBlock:(void (^)(id object, IGListSectionController *sectionController, NSInteger section, BOOL *stop))block { + IGParameterAssert(block != nil); + + BOOL stop = NO; + NSArray *objects = self.objects; + for (NSInteger section = 0; section < objects.count; section++) { + id object = objects[section]; + IGListSectionController *sectionController = [self sectionControllerForObject:object]; + block(object, sectionController, section, &stop); + if (stop) { + break; + } + } +} + + +#pragma mark - NSCopying + +- (id)copyWithZone:(NSZone *)zone { + IGListSectionMap *copy = [[IGListSectionMap allocWithZone:zone] initWithMapTable:self.objectToSectionControllerMap]; + if (copy != nil) { + copy->_sectionControllerToSectionMap = [self.sectionControllerToSectionMap copy]; + copy->_mObjects = [self.mObjects mutableCopy]; + } + return copy; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListWorkingRangeHandler.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListWorkingRangeHandler.h new file mode 100644 index 0000000..c37580d --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListWorkingRangeHandler.h @@ -0,0 +1,40 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListAdapter; + +@interface IGListWorkingRangeHandler : NSObject + +/** + Initializes the working range handler. + + @param workingRangeSize the number of sections beyond the visible viewport that should be considered within the working + range. Applies equally in both directions above and below the viewport. + */ +- (instancetype)initWithWorkingRangeSize:(NSInteger)workingRangeSize; + +/** + Tells the handler that a cell will be displayed in the IGListKit infra. + + @param indexPath The index path of the cell in the UICollectionView. + @param listAdapter The adapter managing the infra. + */ +- (void)willDisplayItemAtIndexPath:(NSIndexPath *)indexPath + forListAdapter:(IGListAdapter *)listAdapter; + +/** + Tells the handler that a cell did end display in the IGListKit infra. + + @param indexPath The index path of the cell in the UICollectionView. + @param listAdapter The adapter managing the infra. + */ +- (void)didEndDisplayingItemAtIndexPath:(NSIndexPath *)indexPath + forListAdapter:(IGListAdapter *)listAdapter; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListWorkingRangeHandler.mm b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListWorkingRangeHandler.mm new file mode 100644 index 0000000..3dd9d91 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/IGListWorkingRangeHandler.mm @@ -0,0 +1,154 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "IGListWorkingRangeHandler.h" + +#import +#import + +#import +#import +#import + +struct _IGListWorkingRangeHandlerIndexPath { + NSInteger section; + NSInteger row; + size_t hash; + + bool operator==(const _IGListWorkingRangeHandlerIndexPath &other) const { + return (section == other.section && row == other.row); + } +}; + +struct _IGListWorkingRangeHandlerSectionControllerWrapper { + IGListSectionController *sectionController; + + bool operator==(const _IGListWorkingRangeHandlerSectionControllerWrapper &other) const { + return (sectionController == other.sectionController); + } +}; + +struct _IGListWorkingRangeHandlerIndexPathHash { + size_t operator()(const _IGListWorkingRangeHandlerIndexPath& o) const { + return (size_t)o.hash; + } +}; + +struct _IGListWorkingRangeHashID { + size_t operator()(const _IGListWorkingRangeHandlerSectionControllerWrapper &o) const { + return (size_t)[o.sectionController hash]; + } +}; + +typedef std::unordered_set<_IGListWorkingRangeHandlerSectionControllerWrapper, _IGListWorkingRangeHashID> _IGListWorkingRangeSectionControllerSet; +typedef std::unordered_set<_IGListWorkingRangeHandlerIndexPath, _IGListWorkingRangeHandlerIndexPathHash> _IGListWorkingRangeIndexPathSet; + +@interface IGListWorkingRangeHandler () + +@property (nonatomic, assign, readonly) NSInteger workingRangeSize; + +@end + +@implementation IGListWorkingRangeHandler { + _IGListWorkingRangeIndexPathSet _visibleSectionIndices; + _IGListWorkingRangeSectionControllerSet _workingRangeSectionControllers; +} + +- (instancetype)initWithWorkingRangeSize:(NSInteger)workingRangeSize { + if (self = [super init]) { + _workingRangeSize = workingRangeSize; + } + return self; +} + +- (void)willDisplayItemAtIndexPath:(NSIndexPath *)indexPath + forListAdapter:(IGListAdapter *)listAdapter { + IGParameterAssert(indexPath != nil); + IGParameterAssert(listAdapter != nil); + + _visibleSectionIndices.insert({ + .section = indexPath.section, + .row = indexPath.row, + .hash = indexPath.hash + }); + + [self _updateWorkingRangesWithListAdapter:listAdapter]; +} + +- (void)didEndDisplayingItemAtIndexPath:(NSIndexPath *)indexPath + forListAdapter:(IGListAdapter *)listAdapter { + IGParameterAssert(indexPath != nil); + IGParameterAssert(listAdapter != nil); + + _visibleSectionIndices.erase({ + .section = indexPath.section, + .row = indexPath.row, + .hash = indexPath.hash + }); + + [self _updateWorkingRangesWithListAdapter:listAdapter]; +} + +#pragma mark - Working Ranges + +- (void)_updateWorkingRangesWithListAdapter:(IGListAdapter *)listAdapter { + IGAssertMainThread(); + // This method is optimized C++ to improve straight-line speed of these operations. Change at your peril. + + // We use a std::set because it is ordered. + std::set visibleSectionSet = std::set(); + for (const _IGListWorkingRangeHandlerIndexPath &indexPath : _visibleSectionIndices) { + visibleSectionSet.insert(indexPath.section); + } + + NSInteger start; + NSInteger end; + if (visibleSectionSet.size() == 0) { + // We're now devoid of any visible sections. Bail + start = 0; + end = 0; + } else { + start = MAX(*visibleSectionSet.begin() - _workingRangeSize, 0); + end = MIN(*visibleSectionSet.rbegin() + 1 + _workingRangeSize, (NSInteger)listAdapter.objects.count); + } + + // Build the current set of working range section controllers + _IGListWorkingRangeSectionControllerSet workingRangeSectionControllers (visibleSectionSet.size()); + for (NSInteger idx = start; idx < end; idx++) { + id item = [listAdapter objectAtSection:idx]; + IGListSectionController *sectionController = [listAdapter sectionControllerForObject:item]; + workingRangeSectionControllers.insert({sectionController}); + } + + IGAssert(workingRangeSectionControllers.size() < 1000, @"This algorithm is way too slow with so many objects:%lu", workingRangeSectionControllers.size()); + + // Tell any new section controllers that they have entered the working range + for (const _IGListWorkingRangeHandlerSectionControllerWrapper &wrapper : workingRangeSectionControllers) { + // Check if the item exists in the old working range item array. + auto it = _workingRangeSectionControllers.find(wrapper); + if (it == _workingRangeSectionControllers.end()) { + // The section controller isn't in the existing list, so it's new. + id workingRangeDelegate = wrapper.sectionController.workingRangeDelegate; + [workingRangeDelegate listAdapter:listAdapter sectionControllerWillEnterWorkingRange:wrapper.sectionController]; + } + } + + // Tell any removed section controllers that they have exited the working range + for (const _IGListWorkingRangeHandlerSectionControllerWrapper &wrapper : _workingRangeSectionControllers) { + // Check if the item exists in the new list of section controllers + auto it = workingRangeSectionControllers.find(wrapper); + if (it == workingRangeSectionControllers.end()) { + // If the item does not exist in the new list, then it's been removed. + id workingRangeDelegate = wrapper.sectionController.workingRangeDelegate; + [workingRangeDelegate listAdapter:listAdapter sectionControllerDidExitWorkingRange:wrapper.sectionController]; + } + } + + _workingRangeSectionControllers = workingRangeSectionControllers; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+DebugDescription.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+DebugDescription.h new file mode 100644 index 0000000..9613142 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+DebugDescription.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@interface UICollectionView (DebugDescription) + +- (NSArray *)debugDescriptionLines; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+DebugDescription.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+DebugDescription.m new file mode 100644 index 0000000..a70758a --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+DebugDescription.m @@ -0,0 +1,43 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "UICollectionView+DebugDescription.h" + +#import + +@implementation UICollectionView (DebugDescription) + +- (NSArray *)debugDescriptionLines { + NSMutableArray *debug = [NSMutableArray new]; +#if IGLK_DEBUG_DESCRIPTION_ENABLED + [debug addObject:[NSString stringWithFormat:@"Class: %@, instance: %p", NSStringFromClass(self.class), self]]; + [debug addObject:[NSString stringWithFormat:@"Data source: %@", self.dataSource]]; + [debug addObject:[NSString stringWithFormat:@"Delegate: %@", self.delegate]]; + [debug addObject:[NSString stringWithFormat:@"Layout: %@", self.collectionViewLayout]]; + [debug addObject:[NSString stringWithFormat:@"Frame: %@, bounds: %@", + NSStringFromCGRect(self.frame), NSStringFromCGRect(self.bounds)]]; + + const NSInteger sections = [self numberOfSections]; + [debug addObject:[NSString stringWithFormat:@"Number of sections: %lld", (long long)sections]]; + + for (NSInteger section = 0; section < sections; section++) { + [debug addObject:[NSString stringWithFormat:@" %lld items in section %lld", + (long long)[self numberOfItemsInSection:section], (long long)section]]; + } + + [debug addObject:@"Visible cell details:"]; + NSArray *visibleIndexPaths = [[self indexPathsForVisibleItems] sortedArrayUsingSelector:@selector(compare:)]; + for (NSIndexPath *path in visibleIndexPaths) { + [debug addObject:[NSString stringWithFormat:@" Visible cell at section %lld, item %lld:", + (long long)path.section, (long long)path.item]]; + [debug addObject:[NSString stringWithFormat:@" %@", [[self cellForItemAtIndexPath:path] description] ?: @""]]; + } +#endif // #if IGLK_DEBUG_DESCRIPTION_ENABLED + return debug; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.h new file mode 100644 index 0000000..acaf6e5 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.h @@ -0,0 +1,16 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@class IGListBatchUpdateData; + +@interface UICollectionView (IGListBatchUpdateData) + +- (void)ig_applyBatchUpdateData:(IGListBatchUpdateData *)updateData; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.m new file mode 100644 index 0000000..3101be1 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.m @@ -0,0 +1,31 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "UICollectionView+IGListBatchUpdateData.h" + +#import + +@implementation UICollectionView (IGListBatchUpdateData) + +- (void)ig_applyBatchUpdateData:(IGListBatchUpdateData *)updateData { + [self deleteItemsAtIndexPaths:updateData.deleteIndexPaths]; + [self insertItemsAtIndexPaths:updateData.insertIndexPaths]; + [self reloadItemsAtIndexPaths:updateData.updateIndexPaths]; + + for (IGListMoveIndexPath *move in updateData.moveIndexPaths) { + [self moveItemAtIndexPath:move.from toIndexPath:move.to]; + } + + for (IGListMoveIndex *move in updateData.moveSections) { + [self moveSection:move.from toSection:move.to]; + } + + [self deleteSections:updateData.deleteSections]; + [self insertSections:updateData.insertSections]; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.h new file mode 100644 index 0000000..bb7e0ff --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.h @@ -0,0 +1,24 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +#import + +NS_ASSUME_NONNULL_BEGIN + +@interface UICollectionViewLayout (InteractiveReordering) + +- (void)ig_hijackLayoutInteractiveReorderingMethodForAdapter:(IGListAdapter *)adapter; + +- (nullable NSIndexPath *)updatedTargetForInteractivelyMovingItem:(NSIndexPath *)previousIndexPath + toIndexPath:(NSIndexPath *)originalTarget + adapter:(IGListAdapter *)adapter; + +@end + +NS_ASSUME_NONNULL_END diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.m new file mode 100644 index 0000000..aebe200 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.m @@ -0,0 +1,195 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "UICollectionViewLayout+InteractiveReordering.h" + +#import + +#import +#import + +@implementation UICollectionViewLayout (InteractiveReordering) + +static void * kIGListAdapterKey = &kIGListAdapterKey; + ++ (void)load +{ + static dispatch_once_t onceToken; + dispatch_once(&onceToken, ^{ + Class layoutClass = [self class]; + + // override implementation for targetIndexPathForInteractivelyMovingItem:withPosition: + SEL userMoveSelector = @selector(targetIndexPathForInteractivelyMovingItem:withPosition:); + SEL overrideSelector = @selector(ig_targetIndexPathForInteractivelyMovingItem:withPosition:); + Method userLayoutMethod = class_getInstanceMethod(layoutClass, userMoveSelector); + Method overrideLayoutMethod = class_getInstanceMethod(layoutClass, overrideSelector); + method_exchangeImplementations(userLayoutMethod, overrideLayoutMethod); + + // override implementation for + // invalidationContextForInteractivelyMovingItems:withTargetPosition:previousIndexPaths:previousPosition: + SEL userInvalidationSelector = + @selector(invalidationContextForInteractivelyMovingItems:withTargetPosition:previousIndexPaths:previousPosition:); + SEL overrideInvalidationSelector = + @selector(ig_invalidationContextForInteractivelyMovingItems:withTargetPosition:previousIndexPaths:previousPosition:); + Method userInvalidationMethod = class_getInstanceMethod(layoutClass, userInvalidationSelector); + Method overrideInvalidationMethod = class_getInstanceMethod(layoutClass, overrideInvalidationSelector); + method_exchangeImplementations(userInvalidationMethod, overrideInvalidationMethod); + + // override implementation for + // invalidationContextForInteractivelyMovingItems:withTargetPosition:previousIndexPaths:previousPosition: + SEL userEndInvalidationSelector = + @selector(invalidationContextForEndingInteractiveMovementOfItemsToFinalIndexPaths:previousIndexPaths:movementCancelled:); + SEL overrideEndInvalidationSelector = + @selector(ig_invalidationContextForEndingInteractiveMovementOfItemsToFinalIndexPaths:previousIndexPaths:movementCancelled:); + Method userEndInvalidationMethod = class_getInstanceMethod(layoutClass, userEndInvalidationSelector); + Method overrideEndInvalidationMethod = class_getInstanceMethod(layoutClass, overrideEndInvalidationSelector); + method_exchangeImplementations(userEndInvalidationMethod, overrideEndInvalidationMethod); + }); +} + +- (void)ig_hijackLayoutInteractiveReorderingMethodForAdapter:(IGListAdapter *)adapter { + objc_setAssociatedObject(self, kIGListAdapterKey, adapter, OBJC_ASSOCIATION_ASSIGN); +} + +- (NSIndexPath *)ig_targetIndexPathForInteractivelyMovingItem:(NSIndexPath *)previousIndexPath + withPosition:(CGPoint)position NS_AVAILABLE_IOS(9_0) { + // call looks recursive, but through swizzling is calling the original implementation for + // targetIndexPathForInteractivelyMovingItem:withPosition: + NSIndexPath *originalTarget = [self ig_targetIndexPathForInteractivelyMovingItem:previousIndexPath + withPosition:position]; + + IGListAdapter *adapter = (IGListAdapter *)objc_getAssociatedObject(self, kIGListAdapterKey); + if (adapter == nil) { + return originalTarget; + } + + NSIndexPath *updatedTarget = [self updatedTargetForInteractivelyMovingItem:previousIndexPath + toIndexPath:originalTarget + adapter:adapter]; + if (updatedTarget) { + return updatedTarget; + } + return originalTarget; +} + +- (nullable NSIndexPath *)updatedTargetForInteractivelyMovingItem:(NSIndexPath *)previousIndexPath + toIndexPath:(NSIndexPath *)originalTarget + adapter:(IGListAdapter *)adapter { + const NSInteger sourceSectionIndex = previousIndexPath.section; + NSInteger destinationSectionIndex = originalTarget.section; + NSInteger destinationItemIndex = originalTarget.item; + + IGListSectionController *sourceSectionController = [adapter sectionControllerForSection:sourceSectionIndex]; + IGListSectionController *destinationSectionController = [adapter sectionControllerForSection:destinationSectionIndex]; + + adapter.isLastInteractiveMoveToLastSectionIndex = NO; + + // this is a reordering of sections themselves + if ([sourceSectionController numberOfItems] == 1 + && [destinationSectionController numberOfItems] == 1) { + + if (destinationItemIndex == 1) { + // the "item" representing our section was dropped + // into the end of a destination section rather than the beginning + // so it really belongs one section after the section where it landed + if (destinationSectionIndex < [[adapter objects] count] - 1) { + destinationSectionIndex += 1; + destinationItemIndex = 0; + } + else { + // if we're moving an item to the last spot, our index would exceed the number of sections available + // so we have to special case this scenario. iOS doesnt allow an item move to "create" a new section + adapter.isLastInteractiveMoveToLastSectionIndex = YES; + } + NSIndexPath *updatedTarget = [NSIndexPath indexPathForItem:destinationItemIndex + inSection:destinationSectionIndex]; + return updatedTarget; + } + } + + return nil; +} + +- (UICollectionViewLayoutInvalidationContext *)ig_invalidationContextForInteractivelyMovingItems:(NSArray *)targetIndexPaths withTargetPosition:(CGPoint)targetPosition previousIndexPaths:(NSArray *)previousIndexPaths previousPosition:(CGPoint)previousPosition { + + // call looks recursive, but through swizzling is calling the original implementation for + // invalidationContextForInteractivelyMovingItems:withTargetPosition:previousIndexPaths:previousPosition: + UICollectionViewLayoutInvalidationContext *originalContext = + [self ig_invalidationContextForInteractivelyMovingItems:targetIndexPaths withTargetPosition:targetPosition previousIndexPaths:previousIndexPaths previousPosition:previousPosition]; + + return [self ig_cleanupInvalidationContext:originalContext]; +} + +- (UICollectionViewLayoutInvalidationContext *)ig_invalidationContextForEndingInteractiveMovementOfItemsToFinalIndexPaths:(NSArray *)indexPaths previousIndexPaths:(NSArray *)previousIndexPaths movementCancelled:(BOOL)movementCancelled { + + // call looks recursive, but through swizzling is calling the original implementation for + // invalidationContextForEndingInteractiveMovementOfItemsToFinalIndexPaths:previousIndexPaths:movementCancelled: + UICollectionViewLayoutInvalidationContext *originalContext = + [self ig_invalidationContextForEndingInteractiveMovementOfItemsToFinalIndexPaths:indexPaths previousIndexPaths:previousIndexPaths movementCancelled:movementCancelled]; + + return [self ig_cleanupInvalidationContext:originalContext]; +} + +- (UICollectionViewLayoutInvalidationContext *)ig_cleanupInvalidationContext:(UICollectionViewLayoutInvalidationContext *)originalContext { + IGListAdapter *adapter = (IGListAdapter *)objc_getAssociatedObject(self, kIGListAdapterKey); + if (adapter == nil || !self.collectionView) { + return originalContext; + } + + const NSInteger numSections = [adapter numberOfSectionsInCollectionView:(UICollectionView * _Nonnull)self.collectionView]; + + // protect against invalidating an index path that no longer exists + // (like item 1 in the last section after interactively reordering an item to the end of a list of 1 item sections) + if ([originalContext.invalidatedItemIndexPaths count] > 0) { + NSUInteger indexToRemove = NSNotFound; + + indexToRemove = [originalContext.invalidatedItemIndexPaths indexOfObjectPassingTest: + ^BOOL(NSIndexPath * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { + if (obj.section == numSections-1) { + IGListSectionController *section = [adapter sectionControllerForSection:obj.section]; + return obj.item > [section numberOfItems] - 1; + } + return NO; + }]; + + if (indexToRemove != NSNotFound) { + NSMutableArray *invalidatedItemIndexPaths = [originalContext.invalidatedItemIndexPaths mutableCopy]; + [invalidatedItemIndexPaths removeObjectAtIndex:indexToRemove]; + + UICollectionViewLayoutInvalidationContext *modifiedContext; + if ([originalContext isKindOfClass:[UICollectionViewFlowLayoutInvalidationContext class]]) { + // UICollectionViewFlowLayout has a special invalidation context subclass + UICollectionViewFlowLayoutInvalidationContext *flowModifiedContext = + [[self.class invalidationContextClass] new]; + + flowModifiedContext.invalidateFlowLayoutDelegateMetrics = + [(UICollectionViewFlowLayoutInvalidationContext *)originalContext invalidateFlowLayoutDelegateMetrics]; + flowModifiedContext.invalidateFlowLayoutAttributes = + [(UICollectionViewFlowLayoutInvalidationContext *)originalContext invalidateFlowLayoutAttributes]; + modifiedContext = flowModifiedContext; + } + else { + modifiedContext = [[self.class invalidationContextClass] new]; + } + + [modifiedContext invalidateItemsAtIndexPaths:invalidatedItemIndexPaths]; + [originalContext.invalidatedSupplementaryIndexPaths enumerateKeysAndObjectsUsingBlock:^(NSString * _Nonnull key, NSArray * _Nonnull obj, BOOL * _Nonnull stop) { + [modifiedContext invalidateSupplementaryElementsOfKind:key atIndexPaths:obj]; + }]; + [originalContext.invalidatedDecorationIndexPaths enumerateKeysAndObjectsUsingBlock:^(NSString * _Nonnull key, NSArray * _Nonnull obj, BOOL * _Nonnull stop) { + [modifiedContext invalidateDecorationElementsOfKind:key atIndexPaths:obj]; + }]; + modifiedContext.contentOffsetAdjustment = originalContext.contentOffsetAdjustment; + modifiedContext.contentSizeAdjustment = originalContext.contentSizeAdjustment; + + return modifiedContext; + } + } + return originalContext; +} + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UIScrollView+IGListKit.h b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UIScrollView+IGListKit.h new file mode 100644 index 0000000..22d1992 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UIScrollView+IGListKit.h @@ -0,0 +1,14 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import + +@interface UIScrollView (IGListKit) + +- (UIEdgeInsets) ig_contentInset; + +@end diff --git a/Demo/Pods/IGListKit/Source/IGListKit/Internal/UIScrollView+IGListKit.m b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UIScrollView+IGListKit.m new file mode 100644 index 0000000..afc7d08 --- /dev/null +++ b/Demo/Pods/IGListKit/Source/IGListKit/Internal/UIScrollView+IGListKit.m @@ -0,0 +1,21 @@ +/** + * Copyright (c) Facebook, Inc. and its affiliates. + * + * This source code is licensed under the MIT license found in the + * LICENSE file in the root directory of this source tree. + */ + +#import "UIScrollView+IGListKit.h" + +@implementation UIScrollView (IGListKit) + +- (UIEdgeInsets) ig_contentInset +{ + if (@available(iOS 11.0, tvOS 11.0, *)) { + return self.adjustedContentInset; + } else { + return self.contentInset; + } +} + +@end diff --git a/Demo/Pods/Kingfisher/LICENSE b/Demo/Pods/Kingfisher/LICENSE new file mode 100644 index 0000000..80888ba --- /dev/null +++ b/Demo/Pods/Kingfisher/LICENSE @@ -0,0 +1,22 @@ +The MIT License (MIT) + +Copyright (c) 2019 Wei Wang + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + diff --git a/Demo/Pods/Kingfisher/README.md b/Demo/Pods/Kingfisher/README.md new file mode 100644 index 0000000..572b847 --- /dev/null +++ b/Demo/Pods/Kingfisher/README.md @@ -0,0 +1,258 @@ +

+Kingfisher +

+ +

+ + + + + +
+ + +

+ +Kingfisher is a powerful, pure-Swift library for downloading and caching images from the web. It provides you a chance to use a pure-Swift way to work with remote images in your next app. + +## Features + +- [x] Asynchronous image downloading and caching. +- [x] Loading image from either `URLSession`-based networking or local provided data. +- [x] Useful image processors and filters provided. +- [x] Multiple-layer hybrid cache for both memory and disk. +- [x] Fine control on cache behavior. Customizable expiration date and size limit. +- [x] Cancelable downloading and auto-reusing previous downloaded content to improve performance. +- [x] Independent components. Use the downloader, caching system, and image processors separately as you need. +- [x] Prefetching images and showing them from the cache to boost your app. +- [x] Extensions for `UIImageView`, `NSImageView`, `NSButton`, `UIButton`, `NSTextAttachment`, `WKInterfaceImage`, `TVMonogramView` and `CPListItem` to directly set an image from a URL. +- [x] Built-in transition animation when setting images. +- [x] Customizable placeholder and indicator while loading images. +- [x] Extensible image processing and image format easily. +- [x] Low Data Mode support. +- [x] SwiftUI support. + +### Kingfisher 101 + +The simplest use-case is setting an image to an image view with the `UIImageView` extension: + +```swift +import Kingfisher + +let url = URL(string: "https://example.com/image.png") +imageView.kf.setImage(with: url) +``` + +Kingfisher will download the image from `url`, send it to both memory cache and disk cache, and display it in `imageView`. +When you set it with the same URL later, the image will be retrieved from the cache and shown immediately. + +It also works if you use SwiftUI: + +```swift +var body: some View { + KFImage(URL(string: "https://example.com/image.png")!) +} +``` + +### A More Advanced Example + +With the powerful options, you can do hard tasks with Kingfisher in a simple way. For example, the code below: + +1. Downloads a high-resolution image. +2. Downsamples it to match the image view size. +3. Makes it round cornered with a given radius. +4. Shows a system indicator and a placeholder image while downloading. +5. When prepared, it animates the small thumbnail image with a "fade in" effect. +6. The original large image is also cached to disk for later use, to get rid of downloading it again in a detail view. +7. A console log is printed when the task finishes, either for success or failure. + +```swift +let url = URL(string: "https://example.com/high_resolution_image.png") +let processor = DownsamplingImageProcessor(size: imageView.bounds.size) + |> RoundCornerImageProcessor(cornerRadius: 20) +imageView.kf.indicatorType = .activity +imageView.kf.setImage( + with: url, + placeholder: UIImage(named: "placeholderImage"), + options: [ + .processor(processor), + .scaleFactor(UIScreen.main.scale), + .transition(.fade(1)), + .cacheOriginalImage + ]) +{ + result in + switch result { + case .success(let value): + print("Task done for: \(value.source.url?.absoluteString ?? "")") + case .failure(let error): + print("Job failed: \(error.localizedDescription)") + } +} +``` + +It is a common situation I can meet in my daily work. Think about how many lines you need to write without +Kingfisher! + +### Method Chaining + +If you are not a fan of the `kf` extension, you can also prefer to use the `KF` builder and chained the method +invocations. The code below is doing the same thing: + +```swift +// Use `kf` extension +imageView.kf.setImage( + with: url, + placeholder: placeholderImage, + options: [ + .processor(processor), + .loadDiskFileSynchronously, + .cacheOriginalImage, + .transition(.fade(0.25)), + .lowDataMode(.network(lowResolutionURL)) + ], + progressBlock: { receivedSize, totalSize in + // Progress updated + }, + completionHandler: { result in + // Done + } +) + +// Use `KF` builder +KF.url(url) + .placeholder(placeholderImage) + .setProcessor(processor) + .loadDiskFileSynchronously() + .cacheMemoryOnly() + .fade(duration: 0.25) + .lowDataModeSource(.network(lowResolutionURL)) + .onProgress { receivedSize, totalSize in } + .onSuccess { result in } + .onFailure { error in } + .set(to: imageView) +``` + +And even better, if later you want to switch to SwiftUI, just change the `KF` above to `KFImage`, and you've done: + +```swift +struct ContentView: View { + var body: some View { + KFImage.url(url) + .placeholder(placeholderImage) + .setProcessor(processor) + .loadDiskFileSynchronously() + .cacheMemoryOnly() + .fade(duration: 0.25) + .lowDataModeSource(.network(lowResolutionURL)) + .onProgress { receivedSize, totalSize in } + .onSuccess { result in } + .onFailure { error in } + } +} +``` + +### Learn More + +To learn the use of Kingfisher by more examples, take a look at the well-prepared [Cheat Sheet](https://github.com/onevcat/Kingfisher/wiki/Cheat-Sheet). +There we summarized the most common tasks in Kingfisher, you can get a better idea of what this framework can do. +There are also some performance tips, remember to check them too. + +## Requirements + +- iOS 12.0+ / macOS 10.14+ / tvOS 12.0+ / watchOS 5.0+ (if you use only UIKit/AppKit) +- iOS 14.0+ / macOS 11.0+ / tvOS 14.0+ / watchOS 7.0+ (if you use it in SwiftUI) +- Swift 5.0+ + +> If you need support from iOS 10 (UIKit/AppKit) or iOS 13 (SwiftUI), use Kingfisher version 6.x. But it won't work +> with Xcode 13.0 and Xcode 13.1 [#1802](https://github.com/onevcat/Kingfisher/issues/1802). +> +> If you need to use Xcode 13.0 and 13.1 but cannot upgrade to v7, use the `version6-xcode13` branch. However, you have to drop +> iOS 10 support due to another Xcode 13 bug. +> +> | UIKit | SwiftUI | Xcode | Kingfisher | +> |---|---|---|---| +> | iOS 10+ | iOS 13+ | 12 | ~> 6.3.1 | +> | iOS 11+ | iOS 13+ | 13 | `version6-xcode13` | +> | iOS 12+ | iOS 14+ | 13 | ~> 7.0 | + +### Installation + +A detailed guide for installation can be found in [Installation Guide](https://github.com/onevcat/Kingfisher/wiki/Installation-Guide). + +#### Swift Package Manager + +- File > Swift Packages > Add Package Dependency +- Add `https://github.com/onevcat/Kingfisher.git` +- Select "Up to Next Major" with "7.0.0" + +#### CocoaPods + +```ruby +source 'https://github.com/CocoaPods/Specs.git' +platform :ios, '12.0' +use_frameworks! + +target 'MyApp' do + pod 'Kingfisher', '~> 7.0' +end +``` + +#### Carthage + +``` +github "onevcat/Kingfisher" ~> 7.0 +``` + + +### Migrating + +[Kingfisher 7.0 Migration](https://github.com/onevcat/Kingfisher/wiki/Kingfisher-7.0-Migration-Guide) - Kingfisher 7.x is NOT fully compatible with the previous version. However, changes should be trivial or not required at all. Please follow the [migration guide](https://github.com/onevcat/Kingfisher/wiki/Kingfisher-7.0-Migration-Guide) when you prepare to upgrade Kingfisher in your project. + +If you are using an even earlier version, see the guides below to know the steps for migrating. + +> - [Kingfisher 6.0 Migration](https://github.com/onevcat/Kingfisher/wiki/Kingfisher-6.0-Migration-Guide) - Kingfisher 6.x is NOT fully compatible with the previous version. However, migration is not difficult. Depending on your use cases, it may take no effect or several minutes to modify your existing code for the new version. Please follow the [migration guide](https://github.com/onevcat/Kingfisher/wiki/Kingfisher-6.0-Migration-Guide) when you prepare to upgrade Kingfisher in your project. +> - [Kingfisher 5.0 Migration](https://github.com/onevcat/Kingfisher/wiki/Kingfisher-5.0-Migration-Guide) - If you are upgrading to Kingfisher 5.x from 4.x, please read this for more information. +> - Kingfisher 4.0 Migration - Kingfisher 3.x should be source compatible to Kingfisher 4. The reason for a major update is that we need to specify the Swift version explicitly for Xcode. All deprecated methods in Kingfisher 3 were removed, so please ensure you have no warning left before you migrate from Kingfisher 3 with Kingfisher 4. If you have any trouble when migrating, please open an issue to discuss. +> - [Kingfisher 3.0 Migration](https://github.com/onevcat/Kingfisher/wiki/Kingfisher-3.0-Migration-Guide) - If you are upgrading to Kingfisher 3.x from an earlier version, please read this for more information. + +## Next Steps + +We prepared a [wiki page](https://github.com/onevcat/Kingfisher/wiki). You can find tons of useful things there. + +* [Installation Guide](https://github.com/onevcat/Kingfisher/wiki/Installation-Guide) - Follow it to integrate Kingfisher into your project. +* [Cheat Sheet](https://github.com/onevcat/Kingfisher/wiki/Cheat-Sheet)- Curious about what Kingfisher could do and how would it look like when used in your project? See this page for useful code snippets. If you are already familiar with Kingfisher, you could also learn new tricks to improve the way you use Kingfisher! +* [API Reference](https://swiftpackageindex.com/onevcat/Kingfisher/master/documentation/kingfisher) - Lastly, please remember to read the full API reference whenever you need more detailed documentation. + +## Other + +### Future of Kingfisher + +I want to keep Kingfisher lightweight. This framework focuses on providing a simple solution for downloading and caching images. This doesn’t mean the framework can’t be improved. Kingfisher is far from perfect, so necessary and useful updates will be made to make it better. + +### Developments and Tests + +Any contributing and pull requests are warmly welcome. However, before you plan to implement some features or try to fix an uncertain issue, it is recommended to open a discussion first. It would be appreciated if your pull requests could build with all tests green. :) + +### About the logo + +The logo of Kingfisher is inspired by [Tangram (七巧板)](http://en.wikipedia.org/wiki/Tangram), a dissection puzzle consisting of seven flat shapes from China. I believe she's a kingfisher bird instead of a swift, but someone insists that she is a pigeon. I guess I should give her a name. Hi, guys, do you have any suggestions? + +### Contact + +Follow and contact me on [Twitter](http://twitter.com/onevcat) or [Sina Weibo](http://weibo.com/onevcat). If you find an issue, [open a ticket](https://github.com/onevcat/Kingfisher/issues/new). Pull requests are warmly welcome as well. + +## Backers & Sponsors + +Open-source projects cannot live long without your help. If you find Kingfisher to be useful, please consider supporting this +project by becoming a sponsor. Your user icon or company logo shows up [on my blog](https://onevcat.com/tabs/about/) with a link to your home page. + +Become a sponsor through [GitHub Sponsors](https://github.com/sponsors/onevcat). :heart: + +Special thanks to: + +[![imgly](https://user-images.githubusercontent.com/1812216/106253726-271ed000-6218-11eb-98e0-c9c681925770.png)](https://img.ly/) + +### License + +Kingfisher is released under the MIT license. See LICENSE for details. diff --git a/Demo/Pods/Kingfisher/Sources/Cache/CacheSerializer.swift b/Demo/Pods/Kingfisher/Sources/Cache/CacheSerializer.swift new file mode 100644 index 0000000..f3a94bd --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Cache/CacheSerializer.swift @@ -0,0 +1,132 @@ +// +// CacheSerializer.swift +// Kingfisher +// +// Created by Wei Wang on 2016/09/02. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import CoreGraphics + +/// An `CacheSerializer` is used to convert some data to an image object after +/// retrieving it from disk storage, and vice versa, to convert an image to data object +/// for storing to the disk storage. +public protocol CacheSerializer { + + /// Gets the serialized data from a provided image + /// and optional original data for caching to disk. + /// + /// - Parameters: + /// - image: The image needed to be serialized. + /// - original: The original data which is just downloaded. + /// If the image is retrieved from cache instead of + /// downloaded, it will be `nil`. + /// - Returns: The data object for storing to disk, or `nil` when no valid + /// data could be serialized. + func data(with image: KFCrossPlatformImage, original: Data?) -> Data? + + /// Gets an image from provided serialized data. + /// + /// - Parameters: + /// - data: The data from which an image should be deserialized. + /// - options: The parsed options for deserialization. + /// - Returns: An image deserialized or `nil` when no valid image + /// could be deserialized. + func image(with data: Data, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? + + /// Whether this serializer prefers to cache the original data in its implementation. + /// If `true`, after creating the image from the disk data, Kingfisher will continue to apply the processor to get + /// the final image. + /// + /// By default, it is `false` and the actual processed image is assumed to be serialized to the disk. + var originalDataUsed: Bool { get } +} + +public extension CacheSerializer { + var originalDataUsed: Bool { false } +} + +/// Represents a basic and default `CacheSerializer` used in Kingfisher disk cache system. +/// It could serialize and deserialize images in PNG, JPEG and GIF format. For +/// image other than these formats, a normalized `pngRepresentation` will be used. +public struct DefaultCacheSerializer: CacheSerializer { + + /// The default general cache serializer used across Kingfisher's cache. + public static let `default` = DefaultCacheSerializer() + + /// The compression quality when converting image to a lossy format data. Default is 1.0. + public var compressionQuality: CGFloat = 1.0 + + /// Whether the original data should be preferred when serializing the image. + /// If `true`, the input original data will be checked first and used unless the data is `nil`. + /// In that case, the serialization will fall back to creating data from image. + public var preferCacheOriginalData: Bool = false + + /// Returnes the `preferCacheOriginalData` value. When the original data is used, Kingfisher needs to re-apply the + /// processors to get the desired final image. + public var originalDataUsed: Bool { preferCacheOriginalData } + + /// Creates a cache serializer that serialize and deserialize images in PNG, JPEG and GIF format. + /// + /// - Note: + /// Use `DefaultCacheSerializer.default` unless you need to specify your own properties. + /// + public init() { } + + /// - Parameters: + /// - image: The image needed to be serialized. + /// - original: The original data which is just downloaded. + /// If the image is retrieved from cache instead of + /// downloaded, it will be `nil`. + /// - Returns: The data object for storing to disk, or `nil` when no valid + /// data could be serialized. + /// + /// - Note: + /// Only when `original` contains valid PNG, JPEG and GIF format data, the `image` will be + /// converted to the corresponding data type. Otherwise, if the `original` is provided but it is not + /// If `original` is `nil`, the input `image` will be encoded as PNG data. + public func data(with image: KFCrossPlatformImage, original: Data?) -> Data? { + if preferCacheOriginalData { + return original ?? + image.kf.data( + format: original?.kf.imageFormat ?? .unknown, + compressionQuality: compressionQuality + ) + } else { + return image.kf.data( + format: original?.kf.imageFormat ?? .unknown, + compressionQuality: compressionQuality + ) + } + } + + /// Gets an image deserialized from provided data. + /// + /// - Parameters: + /// - data: The data from which an image should be deserialized. + /// - options: Options for deserialization. + /// - Returns: An image deserialized or `nil` when no valid image + /// could be deserialized. + public func image(with data: Data, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + return KingfisherWrapper.image(data: data, options: options.imageCreatingOptions) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Cache/DiskStorage.swift b/Demo/Pods/Kingfisher/Sources/Cache/DiskStorage.swift new file mode 100644 index 0000000..89853ce --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Cache/DiskStorage.swift @@ -0,0 +1,588 @@ +// +// DiskStorage.swift +// Kingfisher +// +// Created by Wei Wang on 2018/10/15. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + + +/// Represents a set of conception related to storage which stores a certain type of value in disk. +/// This is a namespace for the disk storage types. A `Backend` with a certain `Config` will be used to describe the +/// storage. See these composed types for more information. +public enum DiskStorage { + + /// Represents a storage back-end for the `DiskStorage`. The value is serialized to data + /// and stored as file in the file system under a specified location. + /// + /// You can config a `DiskStorage.Backend` in its initializer by passing a `DiskStorage.Config` value. + /// or modifying the `config` property after it being created. `DiskStorage` will use file's attributes to keep + /// track of a file for its expiration or size limitation. + public class Backend { + /// The config used for this disk storage. + public var config: Config + + // The final storage URL on disk, with `name` and `cachePathBlock` considered. + public let directoryURL: URL + + let metaChangingQueue: DispatchQueue + + var maybeCached : Set? + let maybeCachedCheckingQueue = DispatchQueue(label: "com.onevcat.Kingfisher.maybeCachedCheckingQueue") + + // `false` if the storage initialized with an error. This prevents unexpected forcibly crash when creating + // storage in the default cache. + private var storageReady: Bool = true + + /// Creates a disk storage with the given `DiskStorage.Config`. + /// + /// - Parameter config: The config used for this disk storage. + /// - Throws: An error if the folder for storage cannot be got or created. + public convenience init(config: Config) throws { + self.init(noThrowConfig: config, creatingDirectory: false) + try prepareDirectory() + } + + // If `creatingDirectory` is `false`, the directory preparation will be skipped. + // We need to call `prepareDirectory` manually after this returns. + init(noThrowConfig config: Config, creatingDirectory: Bool) { + var config = config + + let creation = Creation(config) + self.directoryURL = creation.directoryURL + + // Break any possible retain cycle set by outside. + config.cachePathBlock = nil + self.config = config + + metaChangingQueue = DispatchQueue(label: creation.cacheName) + setupCacheChecking() + + if creatingDirectory { + try? prepareDirectory() + } + } + + private func setupCacheChecking() { + maybeCachedCheckingQueue.async { + do { + self.maybeCached = Set() + try self.config.fileManager.contentsOfDirectory(atPath: self.directoryURL.path).forEach { fileName in + self.maybeCached?.insert(fileName) + } + } catch { + // Just disable the functionality if we fail to initialize it properly. This will just revert to + // the behavior which is to check file existence on disk directly. + self.maybeCached = nil + } + } + } + + // Creates the storage folder. + private func prepareDirectory() throws { + let fileManager = config.fileManager + let path = directoryURL.path + + guard !fileManager.fileExists(atPath: path) else { return } + + do { + try fileManager.createDirectory( + atPath: path, + withIntermediateDirectories: true, + attributes: nil) + } catch { + self.storageReady = false + throw KingfisherError.cacheError(reason: .cannotCreateDirectory(path: path, error: error)) + } + } + + /// Stores a value to the storage under the specified key and expiration policy. + /// - Parameters: + /// - value: The value to be stored. + /// - key: The key to which the `value` will be stored. If there is already a value under the key, + /// the old value will be overwritten by `value`. + /// - expiration: The expiration policy used by this store action. + /// - writeOptions: Data writing options used the new files. + /// - Throws: An error during converting the value to a data format or during writing it to disk. + public func store( + value: T, + forKey key: String, + expiration: StorageExpiration? = nil, + writeOptions: Data.WritingOptions = []) throws + { + guard storageReady else { + throw KingfisherError.cacheError(reason: .diskStorageIsNotReady(cacheURL: directoryURL)) + } + + let expiration = expiration ?? config.expiration + // The expiration indicates that already expired, no need to store. + guard !expiration.isExpired else { return } + + let data: Data + do { + data = try value.toData() + } catch { + throw KingfisherError.cacheError(reason: .cannotConvertToData(object: value, error: error)) + } + + let fileURL = cacheFileURL(forKey: key) + do { + try data.write(to: fileURL, options: writeOptions) + } catch { + throw KingfisherError.cacheError( + reason: .cannotCreateCacheFile(fileURL: fileURL, key: key, data: data, error: error) + ) + } + + let now = Date() + let attributes: [FileAttributeKey : Any] = [ + // The last access date. + .creationDate: now.fileAttributeDate, + // The estimated expiration date. + .modificationDate: expiration.estimatedExpirationSinceNow.fileAttributeDate + ] + do { + try config.fileManager.setAttributes(attributes, ofItemAtPath: fileURL.path) + } catch { + try? config.fileManager.removeItem(at: fileURL) + throw KingfisherError.cacheError( + reason: .cannotSetCacheFileAttribute( + filePath: fileURL.path, + attributes: attributes, + error: error + ) + ) + } + + maybeCachedCheckingQueue.async { + self.maybeCached?.insert(fileURL.lastPathComponent) + } + } + + /// Gets a value from the storage. + /// - Parameters: + /// - key: The cache key of value. + /// - extendingExpiration: The expiration policy used by this getting action. + /// - Throws: An error during converting the data to a value or during operation of disk files. + /// - Returns: The value under `key` if it is valid and found in the storage. Otherwise, `nil`. + public func value(forKey key: String, extendingExpiration: ExpirationExtending = .cacheTime) throws -> T? { + return try value(forKey: key, referenceDate: Date(), actuallyLoad: true, extendingExpiration: extendingExpiration) + } + + func value( + forKey key: String, + referenceDate: Date, + actuallyLoad: Bool, + extendingExpiration: ExpirationExtending) throws -> T? + { + guard storageReady else { + throw KingfisherError.cacheError(reason: .diskStorageIsNotReady(cacheURL: directoryURL)) + } + + let fileManager = config.fileManager + let fileURL = cacheFileURL(forKey: key) + let filePath = fileURL.path + + let fileMaybeCached = maybeCachedCheckingQueue.sync { + return maybeCached?.contains(fileURL.lastPathComponent) ?? true + } + guard fileMaybeCached else { + return nil + } + guard fileManager.fileExists(atPath: filePath) else { + return nil + } + + let meta: FileMeta + do { + let resourceKeys: Set = [.contentModificationDateKey, .creationDateKey] + meta = try FileMeta(fileURL: fileURL, resourceKeys: resourceKeys) + } catch { + throw KingfisherError.cacheError( + reason: .invalidURLResource(error: error, key: key, url: fileURL)) + } + + if meta.expired(referenceDate: referenceDate) { + return nil + } + if !actuallyLoad { return T.empty } + + do { + let data = try Data(contentsOf: fileURL) + let obj = try T.fromData(data) + metaChangingQueue.async { + meta.extendExpiration(with: fileManager, extendingExpiration: extendingExpiration) + } + return obj + } catch { + throw KingfisherError.cacheError(reason: .cannotLoadDataFromDisk(url: fileURL, error: error)) + } + } + + /// Whether there is valid cached data under a given key. + /// - Parameter key: The cache key of value. + /// - Returns: If there is valid data under the key, `true`. Otherwise, `false`. + /// + /// - Note: + /// This method does not actually load the data from disk, so it is faster than directly loading the cached value + /// by checking the nullability of `value(forKey:extendingExpiration:)` method. + /// + public func isCached(forKey key: String) -> Bool { + return isCached(forKey: key, referenceDate: Date()) + } + + /// Whether there is valid cached data under a given key and a reference date. + /// - Parameters: + /// - key: The cache key of value. + /// - referenceDate: A reference date to check whether the cache is still valid. + /// - Returns: If there is valid data under the key, `true`. Otherwise, `false`. + /// + /// - Note: + /// If you pass `Date()` to `referenceDate`, this method is identical to `isCached(forKey:)`. Use the + /// `referenceDate` to determine whether the cache is still valid for a future date. + public func isCached(forKey key: String, referenceDate: Date) -> Bool { + do { + let result = try value( + forKey: key, + referenceDate: referenceDate, + actuallyLoad: false, + extendingExpiration: .none + ) + return result != nil + } catch { + return false + } + } + + /// Removes a value from a specified key. + /// - Parameter key: The cache key of value. + /// - Throws: An error during removing the value. + public func remove(forKey key: String) throws { + let fileURL = cacheFileURL(forKey: key) + try removeFile(at: fileURL) + } + + func removeFile(at url: URL) throws { + try config.fileManager.removeItem(at: url) + } + + /// Removes all values in this storage. + /// - Throws: An error during removing the values. + public func removeAll() throws { + try removeAll(skipCreatingDirectory: false) + } + + func removeAll(skipCreatingDirectory: Bool) throws { + try config.fileManager.removeItem(at: directoryURL) + if !skipCreatingDirectory { + try prepareDirectory() + } + } + + /// The URL of the cached file with a given computed `key`. + /// + /// - Parameter key: The final computed key used when caching the image. Please note that usually this is not + /// the `cacheKey` of an image `Source`. It is the computed key with processor identifier considered. + /// + /// - Note: + /// This method does not guarantee there is an image already cached in the returned URL. It just gives your + /// the URL that the image should be if it exists in disk storage, with the give key. + /// + public func cacheFileURL(forKey key: String) -> URL { + let fileName = cacheFileName(forKey: key) + return directoryURL.appendingPathComponent(fileName, isDirectory: false) + } + + func cacheFileName(forKey key: String) -> String { + if config.usesHashedFileName { + let hashedKey = key.kf.md5 + if let ext = config.pathExtension { + return "\(hashedKey).\(ext)" + } else if config.autoExtAfterHashedFileName, + let ext = key.kf.ext { + return "\(hashedKey).\(ext)" + } + return hashedKey + } else { + if let ext = config.pathExtension { + return "\(key).\(ext)" + } + return key + } + } + + func allFileURLs(for propertyKeys: [URLResourceKey]) throws -> [URL] { + let fileManager = config.fileManager + + guard let directoryEnumerator = fileManager.enumerator( + at: directoryURL, includingPropertiesForKeys: propertyKeys, options: .skipsHiddenFiles) else + { + throw KingfisherError.cacheError(reason: .fileEnumeratorCreationFailed(url: directoryURL)) + } + + guard let urls = directoryEnumerator.allObjects as? [URL] else { + throw KingfisherError.cacheError(reason: .invalidFileEnumeratorContent(url: directoryURL)) + } + return urls + } + + /// Removes all expired values from this storage. + /// - Throws: A file manager error during removing the file. + /// - Returns: The URLs for removed files. + public func removeExpiredValues() throws -> [URL] { + return try removeExpiredValues(referenceDate: Date()) + } + + func removeExpiredValues(referenceDate: Date) throws -> [URL] { + let propertyKeys: [URLResourceKey] = [ + .isDirectoryKey, + .contentModificationDateKey + ] + + let urls = try allFileURLs(for: propertyKeys) + let keys = Set(propertyKeys) + let expiredFiles = urls.filter { fileURL in + do { + let meta = try FileMeta(fileURL: fileURL, resourceKeys: keys) + if meta.isDirectory { + return false + } + return meta.expired(referenceDate: referenceDate) + } catch { + return true + } + } + try expiredFiles.forEach { url in + try removeFile(at: url) + } + return expiredFiles + } + + /// Removes all size exceeded values from this storage. + /// - Throws: A file manager error during removing the file. + /// - Returns: The URLs for removed files. + /// + /// - Note: This method checks `config.sizeLimit` and remove cached files in an LRU (Least Recently Used) way. + func removeSizeExceededValues() throws -> [URL] { + + if config.sizeLimit == 0 { return [] } // Back compatible. 0 means no limit. + + var size = try totalSize() + if size < config.sizeLimit { return [] } + + let propertyKeys: [URLResourceKey] = [ + .isDirectoryKey, + .creationDateKey, + .fileSizeKey + ] + let keys = Set(propertyKeys) + + let urls = try allFileURLs(for: propertyKeys) + var pendings: [FileMeta] = urls.compactMap { fileURL in + guard let meta = try? FileMeta(fileURL: fileURL, resourceKeys: keys) else { + return nil + } + return meta + } + // Sort by last access date. Most recent file first. + pendings.sort(by: FileMeta.lastAccessDate) + + var removed: [URL] = [] + let target = config.sizeLimit / 2 + while size > target, let meta = pendings.popLast() { + size -= UInt(meta.fileSize) + try removeFile(at: meta.url) + removed.append(meta.url) + } + return removed + } + + /// Gets the total file size of the folder in bytes. + public func totalSize() throws -> UInt { + let propertyKeys: [URLResourceKey] = [.fileSizeKey] + let urls = try allFileURLs(for: propertyKeys) + let keys = Set(propertyKeys) + let totalSize: UInt = urls.reduce(0) { size, fileURL in + do { + let meta = try FileMeta(fileURL: fileURL, resourceKeys: keys) + return size + UInt(meta.fileSize) + } catch { + return size + } + } + return totalSize + } + } +} + +extension DiskStorage { + /// Represents the config used in a `DiskStorage`. + public struct Config { + + /// The file size limit on disk of the storage in bytes. 0 means no limit. + public var sizeLimit: UInt + + /// The `StorageExpiration` used in this disk storage. Default is `.days(7)`, + /// means that the disk cache would expire in one week. + public var expiration: StorageExpiration = .days(7) + + /// The preferred extension of cache item. It will be appended to the file name as its extension. + /// Default is `nil`, means that the cache file does not contain a file extension. + public var pathExtension: String? = nil + + /// Default is `true`, means that the cache file name will be hashed before storing. + public var usesHashedFileName = true + + /// Default is `false` + /// If set to `true`, image extension will be extracted from original file name and append to + /// the hased file name and used as the cache key on disk. + public var autoExtAfterHashedFileName = false + + /// Closure that takes in initial directory path and generates + /// the final disk cache path. You can use it to fully customize your cache path. + public var cachePathBlock: ((_ directory: URL, _ cacheName: String) -> URL)! = { + (directory, cacheName) in + return directory.appendingPathComponent(cacheName, isDirectory: true) + } + + let name: String + let fileManager: FileManager + let directory: URL? + + /// Creates a config value based on given parameters. + /// + /// - Parameters: + /// - name: The name of cache. It is used as a part of storage folder. It is used to identify the disk + /// storage. Two storages with the same `name` would share the same folder in disk, and it should + /// be prevented. + /// - sizeLimit: The size limit in bytes for all existing files in the disk storage. + /// - fileManager: The `FileManager` used to manipulate files on disk. Default is `FileManager.default`. + /// - directory: The URL where the disk storage should live. The storage will use this as the root folder, + /// and append a path which is constructed by input `name`. Default is `nil`, indicates that + /// the cache directory under user domain mask will be used. + public init( + name: String, + sizeLimit: UInt, + fileManager: FileManager = .default, + directory: URL? = nil) + { + self.name = name + self.fileManager = fileManager + self.directory = directory + self.sizeLimit = sizeLimit + } + } +} + +extension DiskStorage { + struct FileMeta { + + let url: URL + + let lastAccessDate: Date? + let estimatedExpirationDate: Date? + let isDirectory: Bool + let fileSize: Int + + static func lastAccessDate(lhs: FileMeta, rhs: FileMeta) -> Bool { + return lhs.lastAccessDate ?? .distantPast > rhs.lastAccessDate ?? .distantPast + } + + init(fileURL: URL, resourceKeys: Set) throws { + let meta = try fileURL.resourceValues(forKeys: resourceKeys) + self.init( + fileURL: fileURL, + lastAccessDate: meta.creationDate, + estimatedExpirationDate: meta.contentModificationDate, + isDirectory: meta.isDirectory ?? false, + fileSize: meta.fileSize ?? 0) + } + + init( + fileURL: URL, + lastAccessDate: Date?, + estimatedExpirationDate: Date?, + isDirectory: Bool, + fileSize: Int) + { + self.url = fileURL + self.lastAccessDate = lastAccessDate + self.estimatedExpirationDate = estimatedExpirationDate + self.isDirectory = isDirectory + self.fileSize = fileSize + } + + func expired(referenceDate: Date) -> Bool { + return estimatedExpirationDate?.isPast(referenceDate: referenceDate) ?? true + } + + func extendExpiration(with fileManager: FileManager, extendingExpiration: ExpirationExtending) { + guard let lastAccessDate = lastAccessDate, + let lastEstimatedExpiration = estimatedExpirationDate else + { + return + } + + let attributes: [FileAttributeKey : Any] + + switch extendingExpiration { + case .none: + // not extending expiration time here + return + case .cacheTime: + let originalExpiration: StorageExpiration = + .seconds(lastEstimatedExpiration.timeIntervalSince(lastAccessDate)) + attributes = [ + .creationDate: Date().fileAttributeDate, + .modificationDate: originalExpiration.estimatedExpirationSinceNow.fileAttributeDate + ] + case .expirationTime(let expirationTime): + attributes = [ + .creationDate: Date().fileAttributeDate, + .modificationDate: expirationTime.estimatedExpirationSinceNow.fileAttributeDate + ] + } + + try? fileManager.setAttributes(attributes, ofItemAtPath: url.path) + } + } +} + +extension DiskStorage { + struct Creation { + let directoryURL: URL + let cacheName: String + + init(_ config: Config) { + let url: URL + if let directory = config.directory { + url = directory + } else { + url = config.fileManager.urls(for: .cachesDirectory, in: .userDomainMask)[0] + } + + cacheName = "com.onevcat.Kingfisher.ImageCache.\(config.name)" + directoryURL = config.cachePathBlock(url, cacheName) + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Cache/FormatIndicatedCacheSerializer.swift b/Demo/Pods/Kingfisher/Sources/Cache/FormatIndicatedCacheSerializer.swift new file mode 100644 index 0000000..cdfb7c3 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Cache/FormatIndicatedCacheSerializer.swift @@ -0,0 +1,118 @@ +// +// RequestModifier.swift +// Kingfisher +// +// Created by Junyu Kuang on 5/28/17. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import CoreGraphics + +/// `FormatIndicatedCacheSerializer` lets you indicate an image format for serialized caches. +/// +/// It could serialize and deserialize PNG, JPEG and GIF images. For +/// image other than these formats, a normalized `pngRepresentation` will be used. +/// +/// Example: +/// ```` +/// let profileImageSize = CGSize(width: 44, height: 44) +/// +/// // A round corner image. +/// let imageProcessor = RoundCornerImageProcessor( +/// cornerRadius: profileImageSize.width / 2, targetSize: profileImageSize) +/// +/// let optionsInfo: KingfisherOptionsInfo = [ +/// .cacheSerializer(FormatIndicatedCacheSerializer.png), +/// .processor(imageProcessor)] +/// +/// A URL pointing to a JPEG image. +/// let url = URL(string: "https://example.com/image.jpg")! +/// +/// // Image will be always cached as PNG format to preserve alpha channel for round rectangle. +/// // So when you load it from cache again later, it will be still round cornered. +/// // Otherwise, the corner part would be filled by white color (since JPEG does not contain an alpha channel). +/// imageView.kf.setImage(with: url, options: optionsInfo) +/// ```` +public struct FormatIndicatedCacheSerializer: CacheSerializer { + + /// A `FormatIndicatedCacheSerializer` which converts image from and to PNG format. If the image cannot be + /// represented by PNG format, it will fallback to its real format which is determined by `original` data. + public static let png = FormatIndicatedCacheSerializer(imageFormat: .PNG, jpegCompressionQuality: nil) + + /// A `FormatIndicatedCacheSerializer` which converts image from and to JPEG format. If the image cannot be + /// represented by JPEG format, it will fallback to its real format which is determined by `original` data. + /// The compression quality is 1.0 when using this serializer. If you need to set a customized compression quality, + /// use `jpeg(compressionQuality:)`. + public static let jpeg = FormatIndicatedCacheSerializer(imageFormat: .JPEG, jpegCompressionQuality: 1.0) + + /// A `FormatIndicatedCacheSerializer` which converts image from and to JPEG format with a settable compression + /// quality. If the image cannot be represented by JPEG format, it will fallback to its real format which is + /// determined by `original` data. + /// - Parameter compressionQuality: The compression quality when converting image to JPEG data. + public static func jpeg(compressionQuality: CGFloat) -> FormatIndicatedCacheSerializer { + return FormatIndicatedCacheSerializer(imageFormat: .JPEG, jpegCompressionQuality: compressionQuality) + } + + /// A `FormatIndicatedCacheSerializer` which converts image from and to GIF format. If the image cannot be + /// represented by GIF format, it will fallback to its real format which is determined by `original` data. + public static let gif = FormatIndicatedCacheSerializer(imageFormat: .GIF, jpegCompressionQuality: nil) + + /// The indicated image format. + private let imageFormat: ImageFormat + + /// The compression quality used for loss image format (like JPEG). + private let jpegCompressionQuality: CGFloat? + + /// Creates data which represents the given `image` under a format. + public func data(with image: KFCrossPlatformImage, original: Data?) -> Data? { + + func imageData(withFormat imageFormat: ImageFormat) -> Data? { + return autoreleasepool { () -> Data? in + switch imageFormat { + case .PNG: return image.kf.pngRepresentation() + case .JPEG: return image.kf.jpegRepresentation(compressionQuality: jpegCompressionQuality ?? 1.0) + case .GIF: return image.kf.gifRepresentation() + case .unknown: return nil + } + } + } + + // generate data with indicated image format + if let data = imageData(withFormat: imageFormat) { + return data + } + + let originalFormat = original?.kf.imageFormat ?? .unknown + + // generate data with original image's format + if originalFormat != imageFormat, let data = imageData(withFormat: originalFormat) { + return data + } + + return original ?? image.kf.normalized.kf.pngRepresentation() + } + + /// Same implementation as `DefaultCacheSerializer`. + public func image(with data: Data, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + return KingfisherWrapper.image(data: data, options: options.imageCreatingOptions) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Cache/ImageCache.swift b/Demo/Pods/Kingfisher/Sources/Cache/ImageCache.swift new file mode 100644 index 0000000..508c79a --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Cache/ImageCache.swift @@ -0,0 +1,882 @@ +// +// ImageCache.swift +// Kingfisher +// +// Created by Wei Wang on 15/4/6. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if os(macOS) +import AppKit +#else +import UIKit +#endif + +extension Notification.Name { + /// This notification will be sent when the disk cache got cleaned either there are cached files expired or the + /// total size exceeding the max allowed size. The manually invoking of `clearDiskCache` method will not trigger + /// this notification. + /// + /// The `object` of this notification is the `ImageCache` object which sends the notification. + /// A list of removed hashes (files) could be retrieved by accessing the array under + /// `KingfisherDiskCacheCleanedHashKey` key in `userInfo` of the notification object you received. + /// By checking the array, you could know the hash codes of files are removed. + public static let KingfisherDidCleanDiskCache = + Notification.Name("com.onevcat.Kingfisher.KingfisherDidCleanDiskCache") +} + +/// Key for array of cleaned hashes in `userInfo` of `KingfisherDidCleanDiskCacheNotification`. +public let KingfisherDiskCacheCleanedHashKey = "com.onevcat.Kingfisher.cleanedHash" + +/// Cache type of a cached image. +/// - none: The image is not cached yet when retrieving it. +/// - memory: The image is cached in memory. +/// - disk: The image is cached in disk. +public enum CacheType { + /// The image is not cached yet when retrieving it. + case none + /// The image is cached in memory. + case memory + /// The image is cached in disk. + case disk + + /// Whether the cache type represents the image is already cached or not. + public var cached: Bool { + switch self { + case .memory, .disk: return true + case .none: return false + } + } +} + +/// Represents the caching operation result. +public struct CacheStoreResult { + + /// The cache result for memory cache. Caching an image to memory will never fail. + public let memoryCacheResult: Result<(), Never> + + /// The cache result for disk cache. If an error happens during caching operation, + /// you can get it from `.failure` case of this `diskCacheResult`. + public let diskCacheResult: Result<(), KingfisherError> +} + +extension KFCrossPlatformImage: CacheCostCalculable { + /// Cost of an image + public var cacheCost: Int { return kf.cost } +} + +extension Data: DataTransformable { + public func toData() throws -> Data { + return self + } + + public static func fromData(_ data: Data) throws -> Data { + return data + } + + public static let empty = Data() +} + + +/// Represents the getting image operation from the cache. +/// +/// - disk: The image can be retrieved from disk cache. +/// - memory: The image can be retrieved memory cache. +/// - none: The image does not exist in the cache. +public enum ImageCacheResult { + + /// The image can be retrieved from disk cache. + case disk(KFCrossPlatformImage) + + /// The image can be retrieved memory cache. + case memory(KFCrossPlatformImage) + + /// The image does not exist in the cache. + case none + + /// Extracts the image from cache result. It returns the associated `Image` value for + /// `.disk` and `.memory` case. For `.none` case, `nil` is returned. + public var image: KFCrossPlatformImage? { + switch self { + case .disk(let image): return image + case .memory(let image): return image + case .none: return nil + } + } + + /// Returns the corresponding `CacheType` value based on the result type of `self`. + public var cacheType: CacheType { + switch self { + case .disk: return .disk + case .memory: return .memory + case .none: return .none + } + } +} + +/// Represents a hybrid caching system which is composed by a `MemoryStorage.Backend` and a `DiskStorage.Backend`. +/// `ImageCache` is a high level abstract for storing an image as well as its data to memory and disk, and +/// retrieving them back. +/// +/// While a default image cache object will be used if you prefer the extension methods of Kingfisher, you can create +/// your own cache object and configure its storages as your need. This class also provide an interface for you to set +/// the memory and disk storage config. +open class ImageCache { + + // MARK: Singleton + /// The default `ImageCache` object. Kingfisher will use this cache for its related methods if there is no + /// other cache specified. The `name` of this default cache is "default", and you should not use this name + /// for any of your customize cache. + public static let `default` = ImageCache(name: "default") + + + // MARK: Public Properties + /// The `MemoryStorage.Backend` object used in this cache. This storage holds loaded images in memory with a + /// reasonable expire duration and a maximum memory usage. To modify the configuration of a storage, just set + /// the storage `config` and its properties. + public let memoryStorage: MemoryStorage.Backend + + /// The `DiskStorage.Backend` object used in this cache. This storage stores loaded images in disk with a + /// reasonable expire duration and a maximum disk usage. To modify the configuration of a storage, just set + /// the storage `config` and its properties. + public let diskStorage: DiskStorage.Backend + + private let ioQueue: DispatchQueue + + /// Closure that defines the disk cache path from a given path and cacheName. + public typealias DiskCachePathClosure = (URL, String) -> URL + + // MARK: Initializers + + /// Creates an `ImageCache` from a customized `MemoryStorage` and `DiskStorage`. + /// + /// - Parameters: + /// - memoryStorage: The `MemoryStorage.Backend` object to use in the image cache. + /// - diskStorage: The `DiskStorage.Backend` object to use in the image cache. + public init( + memoryStorage: MemoryStorage.Backend, + diskStorage: DiskStorage.Backend) + { + self.memoryStorage = memoryStorage + self.diskStorage = diskStorage + let ioQueueName = "com.onevcat.Kingfisher.ImageCache.ioQueue.\(UUID().uuidString)" + ioQueue = DispatchQueue(label: ioQueueName) + + let notifications: [(Notification.Name, Selector)] + #if !os(macOS) && !os(watchOS) + notifications = [ + (UIApplication.didReceiveMemoryWarningNotification, #selector(clearMemoryCache)), + (UIApplication.willTerminateNotification, #selector(cleanExpiredDiskCache)), + (UIApplication.didEnterBackgroundNotification, #selector(backgroundCleanExpiredDiskCache)) + ] + #elseif os(macOS) + notifications = [ + (NSApplication.willResignActiveNotification, #selector(cleanExpiredDiskCache)), + ] + #else + notifications = [] + #endif + notifications.forEach { + NotificationCenter.default.addObserver(self, selector: $0.1, name: $0.0, object: nil) + } + } + + /// Creates an `ImageCache` with a given `name`. Both `MemoryStorage` and `DiskStorage` will be created + /// with a default config based on the `name`. + /// + /// - Parameter name: The name of cache object. It is used to setup disk cache directories and IO queue. + /// You should not use the same `name` for different caches, otherwise, the disk storage would + /// be conflicting to each other. The `name` should not be an empty string. + public convenience init(name: String) { + self.init(noThrowName: name, cacheDirectoryURL: nil, diskCachePathClosure: nil) + } + + /// Creates an `ImageCache` with a given `name`, cache directory `path` + /// and a closure to modify the cache directory. + /// + /// - Parameters: + /// - name: The name of cache object. It is used to setup disk cache directories and IO queue. + /// You should not use the same `name` for different caches, otherwise, the disk storage would + /// be conflicting to each other. + /// - cacheDirectoryURL: Location of cache directory URL on disk. It will be internally pass to the + /// initializer of `DiskStorage` as the disk cache directory. If `nil`, the cache + /// directory under user domain mask will be used. + /// - diskCachePathClosure: Closure that takes in an optional initial path string and generates + /// the final disk cache path. You could use it to fully customize your cache path. + /// - Throws: An error that happens during image cache creating, such as unable to create a directory at the given + /// path. + public convenience init( + name: String, + cacheDirectoryURL: URL?, + diskCachePathClosure: DiskCachePathClosure? = nil + ) throws + { + if name.isEmpty { + fatalError("[Kingfisher] You should specify a name for the cache. A cache with empty name is not permitted.") + } + + let memoryStorage = ImageCache.createMemoryStorage() + + let config = ImageCache.createConfig( + name: name, cacheDirectoryURL: cacheDirectoryURL, diskCachePathClosure: diskCachePathClosure + ) + let diskStorage = try DiskStorage.Backend(config: config) + self.init(memoryStorage: memoryStorage, diskStorage: diskStorage) + } + + convenience init( + noThrowName name: String, + cacheDirectoryURL: URL?, + diskCachePathClosure: DiskCachePathClosure? + ) + { + if name.isEmpty { + fatalError("[Kingfisher] You should specify a name for the cache. A cache with empty name is not permitted.") + } + + let memoryStorage = ImageCache.createMemoryStorage() + + let config = ImageCache.createConfig( + name: name, cacheDirectoryURL: cacheDirectoryURL, diskCachePathClosure: diskCachePathClosure + ) + let diskStorage = DiskStorage.Backend(noThrowConfig: config, creatingDirectory: true) + self.init(memoryStorage: memoryStorage, diskStorage: diskStorage) + } + + private static func createMemoryStorage() -> MemoryStorage.Backend { + let totalMemory = ProcessInfo.processInfo.physicalMemory + let costLimit = totalMemory / 4 + let memoryStorage = MemoryStorage.Backend(config: + .init(totalCostLimit: (costLimit > Int.max) ? Int.max : Int(costLimit))) + return memoryStorage + } + + private static func createConfig( + name: String, + cacheDirectoryURL: URL?, + diskCachePathClosure: DiskCachePathClosure? = nil + ) -> DiskStorage.Config + { + var diskConfig = DiskStorage.Config( + name: name, + sizeLimit: 0, + directory: cacheDirectoryURL + ) + if let closure = diskCachePathClosure { + diskConfig.cachePathBlock = closure + } + return diskConfig + } + + deinit { + NotificationCenter.default.removeObserver(self) + } + + // MARK: Storing Images + + open func store(_ image: KFCrossPlatformImage, + original: Data? = nil, + forKey key: String, + options: KingfisherParsedOptionsInfo, + toDisk: Bool = true, + completionHandler: ((CacheStoreResult) -> Void)? = nil) + { + let identifier = options.processor.identifier + let callbackQueue = options.callbackQueue + + let computedKey = key.computedKey(with: identifier) + // Memory storage should not throw. + memoryStorage.storeNoThrow(value: image, forKey: computedKey, expiration: options.memoryCacheExpiration) + + guard toDisk else { + if let completionHandler = completionHandler { + let result = CacheStoreResult(memoryCacheResult: .success(()), diskCacheResult: .success(())) + callbackQueue.execute { completionHandler(result) } + } + return + } + + ioQueue.async { + let serializer = options.cacheSerializer + if let data = serializer.data(with: image, original: original) { + self.syncStoreToDisk( + data, + forKey: key, + processorIdentifier: identifier, + callbackQueue: callbackQueue, + expiration: options.diskCacheExpiration, + writeOptions: options.diskStoreWriteOptions, + completionHandler: completionHandler) + } else { + guard let completionHandler = completionHandler else { return } + + let diskError = KingfisherError.cacheError( + reason: .cannotSerializeImage(image: image, original: original, serializer: serializer)) + let result = CacheStoreResult( + memoryCacheResult: .success(()), + diskCacheResult: .failure(diskError)) + callbackQueue.execute { completionHandler(result) } + } + } + } + + /// Stores an image to the cache. + /// + /// - Parameters: + /// - image: The image to be stored. + /// - original: The original data of the image. This value will be forwarded to the provided `serializer` for + /// further use. By default, Kingfisher uses a `DefaultCacheSerializer` to serialize the image to + /// data for caching in disk, it checks the image format based on `original` data to determine in + /// which image format should be used. For other types of `serializer`, it depends on their + /// implementation detail on how to use this original data. + /// - key: The key used for caching the image. + /// - identifier: The identifier of processor being used for caching. If you are using a processor for the + /// image, pass the identifier of processor to this parameter. + /// - serializer: The `CacheSerializer` + /// - toDisk: Whether this image should be cached to disk or not. If `false`, the image is only cached in memory. + /// Otherwise, it is cached in both memory storage and disk storage. Default is `true`. + /// - callbackQueue: The callback queue on which `completionHandler` is invoked. Default is `.untouch`. For case + /// that `toDisk` is `false`, a `.untouch` queue means `callbackQueue` will be invoked from the + /// caller queue of this method. If `toDisk` is `true`, the `completionHandler` will be called + /// from an internal file IO queue. To change this behavior, specify another `CallbackQueue` + /// value. + /// - completionHandler: A closure which is invoked when the cache operation finishes. + open func store(_ image: KFCrossPlatformImage, + original: Data? = nil, + forKey key: String, + processorIdentifier identifier: String = "", + cacheSerializer serializer: CacheSerializer = DefaultCacheSerializer.default, + toDisk: Bool = true, + callbackQueue: CallbackQueue = .untouch, + completionHandler: ((CacheStoreResult) -> Void)? = nil) + { + struct TempProcessor: ImageProcessor { + let identifier: String + func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + return nil + } + } + + let options = KingfisherParsedOptionsInfo([ + .processor(TempProcessor(identifier: identifier)), + .cacheSerializer(serializer), + .callbackQueue(callbackQueue) + ]) + store(image, original: original, forKey: key, options: options, + toDisk: toDisk, completionHandler: completionHandler) + } + + open func storeToDisk( + _ data: Data, + forKey key: String, + processorIdentifier identifier: String = "", + expiration: StorageExpiration? = nil, + callbackQueue: CallbackQueue = .untouch, + completionHandler: ((CacheStoreResult) -> Void)? = nil) + { + ioQueue.async { + self.syncStoreToDisk( + data, + forKey: key, + processorIdentifier: identifier, + callbackQueue: callbackQueue, + expiration: expiration, + completionHandler: completionHandler) + } + } + + private func syncStoreToDisk( + _ data: Data, + forKey key: String, + processorIdentifier identifier: String = "", + callbackQueue: CallbackQueue = .untouch, + expiration: StorageExpiration? = nil, + writeOptions: Data.WritingOptions = [], + completionHandler: ((CacheStoreResult) -> Void)? = nil) + { + let computedKey = key.computedKey(with: identifier) + let result: CacheStoreResult + do { + try self.diskStorage.store(value: data, forKey: computedKey, expiration: expiration, writeOptions: writeOptions) + result = CacheStoreResult(memoryCacheResult: .success(()), diskCacheResult: .success(())) + } catch { + let diskError: KingfisherError + if let error = error as? KingfisherError { + diskError = error + } else { + diskError = .cacheError(reason: .cannotConvertToData(object: data, error: error)) + } + + result = CacheStoreResult( + memoryCacheResult: .success(()), + diskCacheResult: .failure(diskError) + ) + } + if let completionHandler = completionHandler { + callbackQueue.execute { completionHandler(result) } + } + } + + // MARK: Removing Images + + /// Removes the image for the given key from the cache. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - identifier: The identifier of processor being used for caching. If you are using a processor for the + /// image, pass the identifier of processor to this parameter. + /// - fromMemory: Whether this image should be removed from memory storage or not. + /// If `false`, the image won't be removed from the memory storage. Default is `true`. + /// - fromDisk: Whether this image should be removed from disk storage or not. + /// If `false`, the image won't be removed from the disk storage. Default is `true`. + /// - callbackQueue: The callback queue on which `completionHandler` is invoked. Default is `.untouch`. + /// - completionHandler: A closure which is invoked when the cache removing operation finishes. + open func removeImage(forKey key: String, + processorIdentifier identifier: String = "", + fromMemory: Bool = true, + fromDisk: Bool = true, + callbackQueue: CallbackQueue = .untouch, + completionHandler: (() -> Void)? = nil) + { + let computedKey = key.computedKey(with: identifier) + + if fromMemory { + memoryStorage.remove(forKey: computedKey) + } + + if fromDisk { + ioQueue.async{ + try? self.diskStorage.remove(forKey: computedKey) + if let completionHandler = completionHandler { + callbackQueue.execute { completionHandler() } + } + } + } else { + if let completionHandler = completionHandler { + callbackQueue.execute { completionHandler() } + } + } + } + + // MARK: Getting Images + + /// Gets an image for a given key from the cache, either from memory storage or disk storage. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - options: The `KingfisherParsedOptionsInfo` options setting used for retrieving the image. + /// - callbackQueue: The callback queue on which `completionHandler` is invoked. Default is `.mainCurrentOrAsync`. + /// - completionHandler: A closure which is invoked when the image getting operation finishes. If the + /// image retrieving operation finishes without problem, an `ImageCacheResult` value + /// will be sent to this closure as result. Otherwise, a `KingfisherError` result + /// with detail failing reason will be sent. + open func retrieveImage( + forKey key: String, + options: KingfisherParsedOptionsInfo, + callbackQueue: CallbackQueue = .mainCurrentOrAsync, + completionHandler: ((Result) -> Void)?) + { + // No completion handler. No need to start working and early return. + guard let completionHandler = completionHandler else { return } + + // Try to check the image from memory cache first. + if let image = retrieveImageInMemoryCache(forKey: key, options: options) { + callbackQueue.execute { completionHandler(.success(.memory(image))) } + } else if options.fromMemoryCacheOrRefresh { + callbackQueue.execute { completionHandler(.success(.none)) } + } else { + + // Begin to disk search. + self.retrieveImageInDiskCache(forKey: key, options: options, callbackQueue: callbackQueue) { + result in + switch result { + case .success(let image): + + guard let image = image else { + // No image found in disk storage. + callbackQueue.execute { completionHandler(.success(.none)) } + return + } + + // Cache the disk image to memory. + // We are passing `false` to `toDisk`, the memory cache does not change + // callback queue, we can call `completionHandler` without another dispatch. + var cacheOptions = options + cacheOptions.callbackQueue = .untouch + self.store( + image, + forKey: key, + options: cacheOptions, + toDisk: false) + { + _ in + callbackQueue.execute { completionHandler(.success(.disk(image))) } + } + case .failure(let error): + callbackQueue.execute { completionHandler(.failure(error)) } + } + } + } + } + + /// Gets an image for a given key from the cache, either from memory storage or disk storage. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - options: The `KingfisherOptionsInfo` options setting used for retrieving the image. + /// - callbackQueue: The callback queue on which `completionHandler` is invoked. Default is `.mainCurrentOrAsync`. + /// - completionHandler: A closure which is invoked when the image getting operation finishes. If the + /// image retrieving operation finishes without problem, an `ImageCacheResult` value + /// will be sent to this closure as result. Otherwise, a `KingfisherError` result + /// with detail failing reason will be sent. + /// + /// Note: This method is marked as `open` for only compatible purpose. Do not overide this method. Instead, override + /// the version receives `KingfisherParsedOptionsInfo` instead. + open func retrieveImage(forKey key: String, + options: KingfisherOptionsInfo? = nil, + callbackQueue: CallbackQueue = .mainCurrentOrAsync, + completionHandler: ((Result) -> Void)?) + { + retrieveImage( + forKey: key, + options: KingfisherParsedOptionsInfo(options), + callbackQueue: callbackQueue, + completionHandler: completionHandler) + } + + /// Gets an image for a given key from the memory storage. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - options: The `KingfisherParsedOptionsInfo` options setting used for retrieving the image. + /// - Returns: The image stored in memory cache, if exists and valid. Otherwise, if the image does not exist or + /// has already expired, `nil` is returned. + open func retrieveImageInMemoryCache( + forKey key: String, + options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? + { + let computedKey = key.computedKey(with: options.processor.identifier) + return memoryStorage.value(forKey: computedKey, extendingExpiration: options.memoryCacheAccessExtendingExpiration) + } + + /// Gets an image for a given key from the memory storage. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - options: The `KingfisherOptionsInfo` options setting used for retrieving the image. + /// - Returns: The image stored in memory cache, if exists and valid. Otherwise, if the image does not exist or + /// has already expired, `nil` is returned. + /// + /// Note: This method is marked as `open` for only compatible purpose. Do not overide this method. Instead, override + /// the version receives `KingfisherParsedOptionsInfo` instead. + open func retrieveImageInMemoryCache( + forKey key: String, + options: KingfisherOptionsInfo? = nil) -> KFCrossPlatformImage? + { + return retrieveImageInMemoryCache(forKey: key, options: KingfisherParsedOptionsInfo(options)) + } + + func retrieveImageInDiskCache( + forKey key: String, + options: KingfisherParsedOptionsInfo, + callbackQueue: CallbackQueue = .untouch, + completionHandler: @escaping (Result) -> Void) + { + let computedKey = key.computedKey(with: options.processor.identifier) + let loadingQueue: CallbackQueue = options.loadDiskFileSynchronously ? .untouch : .dispatch(ioQueue) + loadingQueue.execute { + do { + var image: KFCrossPlatformImage? = nil + if let data = try self.diskStorage.value(forKey: computedKey, extendingExpiration: options.diskCacheAccessExtendingExpiration) { + image = options.cacheSerializer.image(with: data, options: options) + } + if options.backgroundDecode { + image = image?.kf.decoded(scale: options.scaleFactor) + } + callbackQueue.execute { completionHandler(.success(image)) } + } catch let error as KingfisherError { + callbackQueue.execute { completionHandler(.failure(error)) } + } catch { + assertionFailure("The internal thrown error should be a `KingfisherError`.") + } + } + } + + /// Gets an image for a given key from the disk storage. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - options: The `KingfisherOptionsInfo` options setting used for retrieving the image. + /// - callbackQueue: The callback queue on which `completionHandler` is invoked. Default is `.untouch`. + /// - completionHandler: A closure which is invoked when the operation finishes. + open func retrieveImageInDiskCache( + forKey key: String, + options: KingfisherOptionsInfo? = nil, + callbackQueue: CallbackQueue = .untouch, + completionHandler: @escaping (Result) -> Void) + { + retrieveImageInDiskCache( + forKey: key, + options: KingfisherParsedOptionsInfo(options), + callbackQueue: callbackQueue, + completionHandler: completionHandler) + } + + // MARK: Cleaning + /// Clears the memory & disk storage of this cache. This is an async operation. + /// + /// - Parameter handler: A closure which is invoked when the cache clearing operation finishes. + /// This `handler` will be called from the main queue. + public func clearCache(completion handler: (() -> Void)? = nil) { + clearMemoryCache() + clearDiskCache(completion: handler) + } + + /// Clears the memory storage of this cache. + @objc public func clearMemoryCache() { + memoryStorage.removeAll() + } + + /// Clears the disk storage of this cache. This is an async operation. + /// + /// - Parameter handler: A closure which is invoked when the cache clearing operation finishes. + /// This `handler` will be called from the main queue. + open func clearDiskCache(completion handler: (() -> Void)? = nil) { + ioQueue.async { + do { + try self.diskStorage.removeAll() + } catch _ { } + if let handler = handler { + DispatchQueue.main.async { handler() } + } + } + } + + /// Clears the expired images from memory & disk storage. This is an async operation. + open func cleanExpiredCache(completion handler: (() -> Void)? = nil) { + cleanExpiredMemoryCache() + cleanExpiredDiskCache(completion: handler) + } + + /// Clears the expired images from disk storage. + open func cleanExpiredMemoryCache() { + memoryStorage.removeExpired() + } + + /// Clears the expired images from disk storage. This is an async operation. + @objc func cleanExpiredDiskCache() { + cleanExpiredDiskCache(completion: nil) + } + + /// Clears the expired images from disk storage. This is an async operation. + /// + /// - Parameter handler: A closure which is invoked when the cache clearing operation finishes. + /// This `handler` will be called from the main queue. + open func cleanExpiredDiskCache(completion handler: (() -> Void)? = nil) { + ioQueue.async { + do { + var removed: [URL] = [] + let removedExpired = try self.diskStorage.removeExpiredValues() + removed.append(contentsOf: removedExpired) + + let removedSizeExceeded = try self.diskStorage.removeSizeExceededValues() + removed.append(contentsOf: removedSizeExceeded) + + if !removed.isEmpty { + DispatchQueue.main.async { + let cleanedHashes = removed.map { $0.lastPathComponent } + NotificationCenter.default.post( + name: .KingfisherDidCleanDiskCache, + object: self, + userInfo: [KingfisherDiskCacheCleanedHashKey: cleanedHashes]) + } + } + + if let handler = handler { + DispatchQueue.main.async { handler() } + } + } catch {} + } + } + +#if !os(macOS) && !os(watchOS) + /// Clears the expired images from disk storage when app is in background. This is an async operation. + /// In most cases, you should not call this method explicitly. + /// It will be called automatically when `UIApplicationDidEnterBackgroundNotification` received. + @objc public func backgroundCleanExpiredDiskCache() { + // if 'sharedApplication()' is unavailable, then return + guard let sharedApplication = KingfisherWrapper.shared else { return } + + func endBackgroundTask(_ task: inout UIBackgroundTaskIdentifier) { + sharedApplication.endBackgroundTask(task) + task = UIBackgroundTaskIdentifier.invalid + } + + var backgroundTask: UIBackgroundTaskIdentifier! + backgroundTask = sharedApplication.beginBackgroundTask { + endBackgroundTask(&backgroundTask!) + } + + cleanExpiredDiskCache { + endBackgroundTask(&backgroundTask!) + } + } +#endif + + // MARK: Image Cache State + + /// Returns the cache type for a given `key` and `identifier` combination. + /// This method is used for checking whether an image is cached in current cache. + /// It also provides information on which kind of cache can it be found in the return value. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - identifier: Processor identifier which used for this image. Default is the `identifier` of + /// `DefaultImageProcessor.default`. + /// - Returns: A `CacheType` instance which indicates the cache status. + /// `.none` means the image is not in cache or it is already expired. + open func imageCachedType( + forKey key: String, + processorIdentifier identifier: String = DefaultImageProcessor.default.identifier) -> CacheType + { + let computedKey = key.computedKey(with: identifier) + if memoryStorage.isCached(forKey: computedKey) { return .memory } + if diskStorage.isCached(forKey: computedKey) { return .disk } + return .none + } + + /// Returns whether the file exists in cache for a given `key` and `identifier` combination. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - identifier: Processor identifier which used for this image. Default is the `identifier` of + /// `DefaultImageProcessor.default`. + /// - Returns: A `Bool` which indicates whether a cache could match the given `key` and `identifier` combination. + /// + /// - Note: + /// The return value does not contain information about from which kind of storage the cache matches. + /// To get the information about cache type according `CacheType`, + /// use `imageCachedType(forKey:processorIdentifier:)` instead. + public func isCached( + forKey key: String, + processorIdentifier identifier: String = DefaultImageProcessor.default.identifier) -> Bool + { + return imageCachedType(forKey: key, processorIdentifier: identifier).cached + } + + /// Gets the hash used as cache file name for the key. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - identifier: Processor identifier which used for this image. Default is the `identifier` of + /// `DefaultImageProcessor.default`. + /// - Returns: The hash which is used as the cache file name. + /// + /// - Note: + /// By default, for a given combination of `key` and `identifier`, `ImageCache` will use the value + /// returned by this method as the cache file name. You can use this value to check and match cache file + /// if you need. + open func hash( + forKey key: String, + processorIdentifier identifier: String = DefaultImageProcessor.default.identifier) -> String + { + let computedKey = key.computedKey(with: identifier) + return diskStorage.cacheFileName(forKey: computedKey) + } + + /// Calculates the size taken by the disk storage. + /// It is the total file size of all cached files in the `diskStorage` on disk in bytes. + /// + /// - Parameter handler: Called with the size calculating finishes. This closure is invoked from the main queue. + open func calculateDiskStorageSize(completion handler: @escaping ((Result) -> Void)) { + ioQueue.async { + do { + let size = try self.diskStorage.totalSize() + DispatchQueue.main.async { handler(.success(size)) } + } catch let error as KingfisherError { + DispatchQueue.main.async { handler(.failure(error)) } + } catch { + assertionFailure("The internal thrown error should be a `KingfisherError`.") + } + } + } + + #if swift(>=5.5) + #if canImport(_Concurrency) + @available(iOS 13.0, macOS 10.15, tvOS 13.0, watchOS 6.0, *) + open var diskStorageSize: UInt { + get async throws { + try await withCheckedThrowingContinuation { continuation in + calculateDiskStorageSize { result in + continuation.resume(with: result) + } + } + } + } + #endif + #endif + + /// Gets the cache path for the key. + /// It is useful for projects with web view or anyone that needs access to the local file path. + /// + /// i.e. Replacing the `` tag in your HTML. + /// + /// - Parameters: + /// - key: The key used for caching the image. + /// - identifier: Processor identifier which used for this image. Default is the `identifier` of + /// `DefaultImageProcessor.default`. + /// - Returns: The disk path of cached image under the given `key` and `identifier`. + /// + /// - Note: + /// This method does not guarantee there is an image already cached in the returned path. It just gives your + /// the path that the image should be, if it exists in disk storage. + /// + /// You could use `isCached(forKey:)` method to check whether the image is cached under that key in disk. + open func cachePath( + forKey key: String, + processorIdentifier identifier: String = DefaultImageProcessor.default.identifier) -> String + { + let computedKey = key.computedKey(with: identifier) + return diskStorage.cacheFileURL(forKey: computedKey).path + } +} + +#if !os(macOS) && !os(watchOS) +// MARK: - For App Extensions +extension UIApplication: KingfisherCompatible { } +extension KingfisherWrapper where Base: UIApplication { + public static var shared: UIApplication? { + let selector = NSSelectorFromString("sharedApplication") + guard Base.responds(to: selector) else { return nil } + return Base.perform(selector).takeUnretainedValue() as? UIApplication + } +} +#endif + +extension String { + func computedKey(with identifier: String) -> String { + if identifier.isEmpty { + return self + } else { + return appending("@\(identifier)") + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Cache/MemoryStorage.swift b/Demo/Pods/Kingfisher/Sources/Cache/MemoryStorage.swift new file mode 100644 index 0000000..10d92b1 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Cache/MemoryStorage.swift @@ -0,0 +1,283 @@ +// +// MemoryStorage.swift +// Kingfisher +// +// Created by Wei Wang on 2018/10/15. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents a set of conception related to storage which stores a certain type of value in memory. +/// This is a namespace for the memory storage types. A `Backend` with a certain `Config` will be used to describe the +/// storage. See these composed types for more information. +public enum MemoryStorage { + + /// Represents a storage which stores a certain type of value in memory. It provides fast access, + /// but limited storing size. The stored value type needs to conform to `CacheCostCalculable`, + /// and its `cacheCost` will be used to determine the cost of size for the cache item. + /// + /// You can config a `MemoryStorage.Backend` in its initializer by passing a `MemoryStorage.Config` value. + /// or modifying the `config` property after it being created. The backend of `MemoryStorage` has + /// upper limitation on cost size in memory and item count. All items in the storage has an expiration + /// date. When retrieved, if the target item is already expired, it will be recognized as it does not + /// exist in the storage. The `MemoryStorage` also contains a scheduled self clean task, to evict expired + /// items from memory. + public class Backend { + let storage = NSCache>() + + // Keys trackes the objects once inside the storage. For object removing triggered by user, the corresponding + // key would be also removed. However, for the object removing triggered by cache rule/policy of system, the + // key will be remained there until next `removeExpired` happens. + // + // Breaking the strict tracking could save additional locking behaviors. + // See https://github.com/onevcat/Kingfisher/issues/1233 + var keys = Set() + + private var cleanTimer: Timer? = nil + private let lock = NSLock() + + /// The config used in this storage. It is a value you can set and + /// use to config the storage in air. + public var config: Config { + didSet { + storage.totalCostLimit = config.totalCostLimit + storage.countLimit = config.countLimit + } + } + + /// Creates a `MemoryStorage` with a given `config`. + /// + /// - Parameter config: The config used to create the storage. It determines the max size limitation, + /// default expiration setting and more. + public init(config: Config) { + self.config = config + storage.totalCostLimit = config.totalCostLimit + storage.countLimit = config.countLimit + + cleanTimer = .scheduledTimer(withTimeInterval: config.cleanInterval, repeats: true) { [weak self] _ in + guard let self = self else { return } + self.removeExpired() + } + } + + /// Removes the expired values from the storage. + public func removeExpired() { + lock.lock() + defer { lock.unlock() } + for key in keys { + let nsKey = key as NSString + guard let object = storage.object(forKey: nsKey) else { + // This could happen if the object is moved by cache `totalCostLimit` or `countLimit` rule. + // We didn't remove the key yet until now, since we do not want to introduce additional lock. + // See https://github.com/onevcat/Kingfisher/issues/1233 + keys.remove(key) + continue + } + if object.isExpired { + storage.removeObject(forKey: nsKey) + keys.remove(key) + } + } + } + + /// Stores a value to the storage under the specified key and expiration policy. + /// - Parameters: + /// - value: The value to be stored. + /// - key: The key to which the `value` will be stored. + /// - expiration: The expiration policy used by this store action. + /// - Throws: No error will + public func store( + value: T, + forKey key: String, + expiration: StorageExpiration? = nil) + { + storeNoThrow(value: value, forKey: key, expiration: expiration) + } + + // The no throw version for storing value in cache. Kingfisher knows the detail so it + // could use this version to make syntax simpler internally. + func storeNoThrow( + value: T, + forKey key: String, + expiration: StorageExpiration? = nil) + { + lock.lock() + defer { lock.unlock() } + let expiration = expiration ?? config.expiration + // The expiration indicates that already expired, no need to store. + guard !expiration.isExpired else { return } + + let object: StorageObject + if config.keepWhenEnteringBackground { + object = BackgroundKeepingStorageObject(value, expiration: expiration) + } else { + object = StorageObject(value, expiration: expiration) + } + storage.setObject(object, forKey: key as NSString, cost: value.cacheCost) + keys.insert(key) + } + + /// Gets a value from the storage. + /// + /// - Parameters: + /// - key: The cache key of value. + /// - extendingExpiration: The expiration policy used by this getting action. + /// - Returns: The value under `key` if it is valid and found in the storage. Otherwise, `nil`. + public func value(forKey key: String, extendingExpiration: ExpirationExtending = .cacheTime) -> T? { + guard let object = storage.object(forKey: key as NSString) else { + return nil + } + if object.isExpired { + return nil + } + object.extendExpiration(extendingExpiration) + return object.value + } + + /// Whether there is valid cached data under a given key. + /// - Parameter key: The cache key of value. + /// - Returns: If there is valid data under the key, `true`. Otherwise, `false`. + public func isCached(forKey key: String) -> Bool { + guard let _ = value(forKey: key, extendingExpiration: .none) else { + return false + } + return true + } + + /// Removes a value from a specified key. + /// - Parameter key: The cache key of value. + public func remove(forKey key: String) { + lock.lock() + defer { lock.unlock() } + storage.removeObject(forKey: key as NSString) + keys.remove(key) + } + + /// Removes all values in this storage. + public func removeAll() { + lock.lock() + defer { lock.unlock() } + storage.removeAllObjects() + keys.removeAll() + } + } +} + +extension MemoryStorage { + /// Represents the config used in a `MemoryStorage`. + public struct Config { + + /// Total cost limit of the storage in bytes. + public var totalCostLimit: Int + + /// The item count limit of the memory storage. + public var countLimit: Int = .max + + /// The `StorageExpiration` used in this memory storage. Default is `.seconds(300)`, + /// means that the memory cache would expire in 5 minutes. + public var expiration: StorageExpiration = .seconds(300) + + /// The time interval between the storage do clean work for swiping expired items. + public var cleanInterval: TimeInterval + + /// Whether the newly added items to memory cache should be purged when the app goes to background. + /// + /// By default, the cached items in memory will be purged as soon as the app goes to background to ensure + /// least memory footprint. Enabling this would prevent this behavior and keep the items alive in cache even + /// when your app is not in foreground anymore. + /// + /// Default is `false`. After setting `true`, only the newly added cache objects are affected. Existing + /// objects which are already in the cache while this value was `false` will be still be purged when entering + /// background. + public var keepWhenEnteringBackground: Bool = false + + /// Creates a config from a given `totalCostLimit` value. + /// + /// - Parameters: + /// - totalCostLimit: Total cost limit of the storage in bytes. + /// - cleanInterval: The time interval between the storage do clean work for swiping expired items. + /// Default is 120, means the auto eviction happens once per two minutes. + /// + /// - Note: + /// Other members of `MemoryStorage.Config` will use their default values when created. + public init(totalCostLimit: Int, cleanInterval: TimeInterval = 120) { + self.totalCostLimit = totalCostLimit + self.cleanInterval = cleanInterval + } + } +} + +extension MemoryStorage { + + class BackgroundKeepingStorageObject: StorageObject, NSDiscardableContent { + var accessing = true + func beginContentAccess() -> Bool { + if value != nil { + accessing = true + } else { + accessing = false + } + return accessing + } + + func endContentAccess() { + accessing = false + } + + func discardContentIfPossible() { + value = nil + } + + func isContentDiscarded() -> Bool { + return value == nil + } + } + + class StorageObject { + var value: T? + let expiration: StorageExpiration + + private(set) var estimatedExpiration: Date + + init(_ value: T, expiration: StorageExpiration) { + self.value = value + self.expiration = expiration + + self.estimatedExpiration = expiration.estimatedExpirationSinceNow + } + + func extendExpiration(_ extendingExpiration: ExpirationExtending = .cacheTime) { + switch extendingExpiration { + case .none: + return + case .cacheTime: + self.estimatedExpiration = expiration.estimatedExpirationSinceNow + case .expirationTime(let expirationTime): + self.estimatedExpiration = expirationTime.estimatedExpirationSinceNow + } + } + + var isExpired: Bool { + return estimatedExpiration.isPast + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Cache/Storage.swift b/Demo/Pods/Kingfisher/Sources/Cache/Storage.swift new file mode 100644 index 0000000..ad9d326 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Cache/Storage.swift @@ -0,0 +1,110 @@ +// +// Storage.swift +// Kingfisher +// +// Created by Wei Wang on 2018/10/15. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Constants for some time intervals +struct TimeConstants { + static let secondsInOneDay = 86_400 +} + +/// Represents the expiration strategy used in storage. +/// +/// - never: The item never expires. +/// - seconds: The item expires after a time duration of given seconds from now. +/// - days: The item expires after a time duration of given days from now. +/// - date: The item expires after a given date. +public enum StorageExpiration { + /// The item never expires. + case never + /// The item expires after a time duration of given seconds from now. + case seconds(TimeInterval) + /// The item expires after a time duration of given days from now. + case days(Int) + /// The item expires after a given date. + case date(Date) + /// Indicates the item is already expired. Use this to skip cache. + case expired + + func estimatedExpirationSince(_ date: Date) -> Date { + switch self { + case .never: return .distantFuture + case .seconds(let seconds): + return date.addingTimeInterval(seconds) + case .days(let days): + let duration: TimeInterval = TimeInterval(TimeConstants.secondsInOneDay) * TimeInterval(days) + return date.addingTimeInterval(duration) + case .date(let ref): + return ref + case .expired: + return .distantPast + } + } + + var estimatedExpirationSinceNow: Date { + return estimatedExpirationSince(Date()) + } + + var isExpired: Bool { + return timeInterval <= 0 + } + + var timeInterval: TimeInterval { + switch self { + case .never: return .infinity + case .seconds(let seconds): return seconds + case .days(let days): return TimeInterval(TimeConstants.secondsInOneDay) * TimeInterval(days) + case .date(let ref): return ref.timeIntervalSinceNow + case .expired: return -(.infinity) + } + } +} + +/// Represents the expiration extending strategy used in storage to after access. +/// +/// - none: The item expires after the original time, without extending after access. +/// - cacheTime: The item expiration extends by the original cache time after each access. +/// - expirationTime: The item expiration extends by the provided time after each access. +public enum ExpirationExtending { + /// The item expires after the original time, without extending after access. + case none + /// The item expiration extends by the original cache time after each access. + case cacheTime + /// The item expiration extends by the provided time after each access. + case expirationTime(_ expiration: StorageExpiration) +} + +/// Represents types which cost in memory can be calculated. +public protocol CacheCostCalculable { + var cacheCost: Int { get } +} + +/// Represents types which can be converted to and from data. +public protocol DataTransformable { + func toData() throws -> Data + static func fromData(_ data: Data) throws -> Self + static var empty: Self { get } +} diff --git a/Demo/Pods/Kingfisher/Sources/Extensions/CPListItem+Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/Extensions/CPListItem+Kingfisher.swift new file mode 100644 index 0000000..085bead --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Extensions/CPListItem+Kingfisher.swift @@ -0,0 +1,245 @@ + +// +// CPListItem+Kingfisher.swift +// Kingfisher +// +// Created by Wayne Hartman on 2021-08-29. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(CarPlay) && !targetEnvironment(macCatalyst) +import CarPlay + +@available(iOS 14.0, *) +extension KingfisherWrapper where Base: CPListItem { + + // MARK: Setting Image + + /// Sets an image to the image view with a source. + /// + /// - Parameters: + /// - source: The `Source` object contains information about the image. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested source + /// Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? [])) + return setImage( + with: source, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + /// Sets an image to the image view with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the image. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with resource: Resource?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: resource?.convertToSource(), + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var mutatingSelf = self + guard let source = source else { + /** + * In iOS SDK 14.0-14.4 the image param was non-`nil`. The SDK changed in 14.5 + * to allow `nil`. The compiler version 5.4 was introduced in this same SDK, + * which allows >=14.5 SDK to set a `nil` image. This compile check allows + * newer SDK users to set the image to `nil`, while still allowing older SDK + * users to compile the framework. + */ + #if compiler(>=5.4) + self.base.setImage(placeholder) + #else + if let placeholder = placeholder { + self.base.setImage(placeholder) + } + #endif + + mutatingSelf.taskIdentifier = nil + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + /** + * In iOS SDK 14.0-14.4 the image param was non-`nil`. The SDK changed in 14.5 + * to allow `nil`. The compiler version 5.4 was introduced in this same SDK, + * which allows >=14.5 SDK to set a `nil` image. This compile check allows + * newer SDK users to set the image to `nil`, while still allowing older SDK + * users to compile the framework. + */ + #if compiler(>=5.4) + self.base.setImage(placeholder) + #else // Let older SDK users deal with the older behavior. + if let placeholder = placeholder { + self.base.setImage(placeholder) + } + #endif + } + + let issuedIdentifier = Source.Identifier.next() + mutatingSelf.taskIdentifier = issuedIdentifier + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.imageTask = $0 }, + progressiveImageSetter: { self.base.setImage($0) }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.taskIdentifier }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.taskIdentifier else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.imageTask = nil + mutatingSelf.taskIdentifier = nil + + switch result { + case .success(let value): + self.base.setImage(value.image) + completionHandler?(result) + + case .failure: + if let image = options.onFailureImage { + /** + * In iOS SDK 14.0-14.4 the image param was non-`nil`. The SDK changed in 14.5 + * to allow `nil`. The compiler version 5.4 was introduced in this same SDK, + * which allows >=14.5 SDK to set a `nil` image. This compile check allows + * newer SDK users to set the image to `nil`, while still allowing older SDK + * users to compile the framework. + */ + #if compiler(>=5.4) + self.base.setImage(image) + #else // Let older SDK users deal with the older behavior. + if let unwrapped = image { + self.base.setImage(unwrapped) + } + #endif + } + completionHandler?(result) + } + } + } + ) + + mutatingSelf.imageTask = task + return task + } + + // MARK: Cancelling Image + + /// Cancel the image download task bounded to the image view if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelDownloadTask() { + imageTask?.cancel() + } +} + +private var taskIdentifierKey: Void? +private var imageTaskKey: Void? + +// MARK: Properties +extension KingfisherWrapper where Base: CPListItem { + + public private(set) var taskIdentifier: Source.Identifier.Value? { + get { + let box: Box? = getAssociatedObject(base, &taskIdentifierKey) + return box?.value + } + set { + let box = newValue.map { Box($0) } + setRetainedAssociatedObject(base, &taskIdentifierKey, box) + } + } + + private var imageTask: DownloadTask? { + get { return getAssociatedObject(base, &imageTaskKey) } + set { setRetainedAssociatedObject(base, &imageTaskKey, newValue)} + } +} +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Extensions/ImageView+Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/Extensions/ImageView+Kingfisher.swift new file mode 100644 index 0000000..9378f19 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Extensions/ImageView+Kingfisher.swift @@ -0,0 +1,537 @@ +// +// ImageView+Kingfisher.swift +// Kingfisher +// +// Created by Wei Wang on 15/4/6. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if !os(watchOS) + +#if os(macOS) +import AppKit +#else +import UIKit +#endif + +extension KingfisherWrapper where Base: KFCrossPlatformImageView { + + // MARK: Setting Image + + /// Sets an image to the image view with a `Source`. + /// + /// - Parameters: + /// - source: The `Source` object defines data information from network or a data provider. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// This is the easiest way to use Kingfisher to boost the image setting process from a source. Since all parameters + /// have a default value except the `source`, you can set an image from a certain URL to an image view like this: + /// + /// ``` + /// // Set image from a network source. + /// let url = URL(string: "https://example.com/image.png")! + /// imageView.kf.setImage(with: .network(url)) + /// + /// // Or set image from a data provider. + /// let provider = LocalFileImageDataProvider(fileURL: fileURL) + /// imageView.kf.setImage(with: .provider(provider)) + /// ``` + /// + /// For both `.network` and `.provider` source, there are corresponding view extension methods. So the code + /// above is equivalent to: + /// + /// ``` + /// imageView.kf.setImage(with: url) + /// imageView.kf.setImage(with: provider) + /// ``` + /// + /// Internally, this method will use `KingfisherManager` to get the source. + /// Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with source: Source?, + placeholder: Placeholder? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setImage(with: source, placeholder: placeholder, parsedOptions: options, progressBlock: progressBlock, completionHandler: completionHandler) + } + + /// Sets an image to the image view with a `Source`. + /// + /// - Parameters: + /// - source: The `Source` object defines data information from network or a data provider. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// This is the easiest way to use Kingfisher to boost the image setting process from a source. Since all parameters + /// have a default value except the `source`, you can set an image from a certain URL to an image view like this: + /// + /// ``` + /// // Set image from a network source. + /// let url = URL(string: "https://example.com/image.png")! + /// imageView.kf.setImage(with: .network(url)) + /// + /// // Or set image from a data provider. + /// let provider = LocalFileImageDataProvider(fileURL: fileURL) + /// imageView.kf.setImage(with: .provider(provider)) + /// ``` + /// + /// For both `.network` and `.provider` source, there are corresponding view extension methods. So the code + /// above is equivalent to: + /// + /// ``` + /// imageView.kf.setImage(with: url) + /// imageView.kf.setImage(with: provider) + /// ``` + /// + /// Internally, this method will use `KingfisherManager` to get the source. + /// Since this method will perform UI changes, you must call it from the main thread. + /// The `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with source: Source?, + placeholder: Placeholder? = nil, + options: KingfisherOptionsInfo? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: source, + placeholder: placeholder, + options: options, + progressBlock: nil, + completionHandler: completionHandler + ) + } + + /// Sets an image to the image view with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the resource. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// This is the easiest way to use Kingfisher to boost the image setting process from network. Since all parameters + /// have a default value except the `resource`, you can set an image from a certain URL to an image view like this: + /// + /// ``` + /// let url = URL(string: "https://example.com/image.png")! + /// imageView.kf.setImage(with: url) + /// ``` + /// + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with resource: Resource?, + placeholder: Placeholder? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: resource?.convertToSource(), + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + /// Sets an image to the image view with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the resource. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// This is the easiest way to use Kingfisher to boost the image setting process from network. Since all parameters + /// have a default value except the `resource`, you can set an image from a certain URL to an image view like this: + /// + /// ``` + /// let url = URL(string: "https://example.com/image.png")! + /// imageView.kf.setImage(with: url) + /// ``` + /// + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// The `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with resource: Resource?, + placeholder: Placeholder? = nil, + options: KingfisherOptionsInfo? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: resource, + placeholder: placeholder, + options: options, + progressBlock: nil, + completionHandler: completionHandler + ) + } + + /// Sets an image to the image view with a data provider. + /// + /// - Parameters: + /// - provider: The `ImageDataProvider` object contains information about the data. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// Internally, this method will use `KingfisherManager` to get the image data, from either cache + /// or the data provider. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with provider: ImageDataProvider?, + placeholder: Placeholder? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: provider.map { .provider($0) }, + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + /// Sets an image to the image view with a data provider. + /// + /// - Parameters: + /// - provider: The `ImageDataProvider` object contains information about the data. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// Internally, this method will use `KingfisherManager` to get the image data, from either cache + /// or the data provider. Since this method will perform UI changes, you must call it from the main thread. + /// The `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with provider: ImageDataProvider?, + placeholder: Placeholder? = nil, + options: KingfisherOptionsInfo? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: provider, + placeholder: placeholder, + options: options, + progressBlock: nil, + completionHandler: completionHandler + ) + } + + + func setImage( + with source: Source?, + placeholder: Placeholder? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var mutatingSelf = self + guard let source = source else { + mutatingSelf.placeholder = placeholder + mutatingSelf.taskIdentifier = nil + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + + let isEmptyImage = base.image == nil && self.placeholder == nil + if !options.keepCurrentImageWhileLoading || isEmptyImage { + // Always set placeholder while there is no image/placeholder yet. + mutatingSelf.placeholder = placeholder + } + + let maybeIndicator = indicator + maybeIndicator?.startAnimatingView() + + let issuedIdentifier = Source.Identifier.next() + mutatingSelf.taskIdentifier = issuedIdentifier + + if base.shouldPreloadAllAnimation() { + options.preloadAllAnimationData = true + } + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.imageTask = $0 }, + progressiveImageSetter: { self.base.image = $0 }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.taskIdentifier }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + maybeIndicator?.stopAnimatingView() + guard issuedIdentifier == self.taskIdentifier else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.imageTask = nil + mutatingSelf.taskIdentifier = nil + + switch result { + case .success(let value): + guard self.needsTransition(options: options, cacheType: value.cacheType) else { + mutatingSelf.placeholder = nil + self.base.image = value.image + completionHandler?(result) + return + } + + self.makeTransition(image: value.image, transition: options.transition) { + completionHandler?(result) + } + + case .failure: + if let image = options.onFailureImage { + mutatingSelf.placeholder = nil + self.base.image = image + } + completionHandler?(result) + } + } + } + ) + mutatingSelf.imageTask = task + return task + } + + // MARK: Cancelling Downloading Task + + /// Cancels the image download task of the image view if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelDownloadTask() { + imageTask?.cancel() + } + + private func needsTransition(options: KingfisherParsedOptionsInfo, cacheType: CacheType) -> Bool { + switch options.transition { + case .none: + return false + #if os(macOS) + case .fade: // Fade is only a placeholder for SwiftUI on macOS. + return false + #else + default: + if options.forceTransition { return true } + if cacheType == .none { return true } + return false + #endif + } + } + + private func makeTransition(image: KFCrossPlatformImage, transition: ImageTransition, done: @escaping () -> Void) { + #if !os(macOS) + // Force hiding the indicator without transition first. + UIView.transition( + with: self.base, + duration: 0.0, + options: [], + animations: { self.indicator?.stopAnimatingView() }, + completion: { _ in + var mutatingSelf = self + mutatingSelf.placeholder = nil + UIView.transition( + with: self.base, + duration: transition.duration, + options: [transition.animationOptions, .allowUserInteraction], + animations: { transition.animations?(self.base, image) }, + completion: { finished in + transition.completion?(finished) + done() + } + ) + } + ) + #else + done() + #endif + } +} + +// MARK: - Associated Object +private var taskIdentifierKey: Void? +private var indicatorKey: Void? +private var indicatorTypeKey: Void? +private var placeholderKey: Void? +private var imageTaskKey: Void? + +extension KingfisherWrapper where Base: KFCrossPlatformImageView { + + // MARK: Properties + public private(set) var taskIdentifier: Source.Identifier.Value? { + get { + let box: Box? = getAssociatedObject(base, &taskIdentifierKey) + return box?.value + } + set { + let box = newValue.map { Box($0) } + setRetainedAssociatedObject(base, &taskIdentifierKey, box) + } + } + + /// Holds which indicator type is going to be used. + /// Default is `.none`, means no indicator will be shown while downloading. + public var indicatorType: IndicatorType { + get { + return getAssociatedObject(base, &indicatorTypeKey) ?? .none + } + + set { + switch newValue { + case .none: indicator = nil + case .activity: indicator = ActivityIndicator() + case .image(let data): indicator = ImageIndicator(imageData: data) + case .custom(let anIndicator): indicator = anIndicator + } + + setRetainedAssociatedObject(base, &indicatorTypeKey, newValue) + } + } + + /// Holds any type that conforms to the protocol `Indicator`. + /// The protocol `Indicator` has a `view` property that will be shown when loading an image. + /// It will be `nil` if `indicatorType` is `.none`. + public private(set) var indicator: Indicator? { + get { + let box: Box? = getAssociatedObject(base, &indicatorKey) + return box?.value + } + + set { + // Remove previous + if let previousIndicator = indicator { + previousIndicator.view.removeFromSuperview() + } + + // Add new + if let newIndicator = newValue { + // Set default indicator layout + let view = newIndicator.view + + base.addSubview(view) + view.translatesAutoresizingMaskIntoConstraints = false + view.centerXAnchor.constraint( + equalTo: base.centerXAnchor, constant: newIndicator.centerOffset.x).isActive = true + view.centerYAnchor.constraint( + equalTo: base.centerYAnchor, constant: newIndicator.centerOffset.y).isActive = true + + switch newIndicator.sizeStrategy(in: base) { + case .intrinsicSize: + break + case .full: + view.heightAnchor.constraint(equalTo: base.heightAnchor, constant: 0).isActive = true + view.widthAnchor.constraint(equalTo: base.widthAnchor, constant: 0).isActive = true + case .size(let size): + view.heightAnchor.constraint(equalToConstant: size.height).isActive = true + view.widthAnchor.constraint(equalToConstant: size.width).isActive = true + } + + newIndicator.view.isHidden = true + } + + // Save in associated object + // Wrap newValue with Box to workaround an issue that Swift does not recognize + // and casting protocol for associate object correctly. https://github.com/onevcat/Kingfisher/issues/872 + setRetainedAssociatedObject(base, &indicatorKey, newValue.map(Box.init)) + } + } + + private var imageTask: DownloadTask? { + get { return getAssociatedObject(base, &imageTaskKey) } + set { setRetainedAssociatedObject(base, &imageTaskKey, newValue)} + } + + /// Represents the `Placeholder` used for this image view. A `Placeholder` will be shown in the view while + /// it is downloading an image. + public private(set) var placeholder: Placeholder? { + get { return getAssociatedObject(base, &placeholderKey) } + set { + if let previousPlaceholder = placeholder { + previousPlaceholder.remove(from: base) + } + + if let newPlaceholder = newValue { + newPlaceholder.add(to: base) + } else { + base.image = nil + } + setRetainedAssociatedObject(base, &placeholderKey, newValue) + } + } +} + + +extension KFCrossPlatformImageView { + @objc func shouldPreloadAllAnimation() -> Bool { return true } +} + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Extensions/NSButton+Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/Extensions/NSButton+Kingfisher.swift new file mode 100644 index 0000000..d33d557 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Extensions/NSButton+Kingfisher.swift @@ -0,0 +1,362 @@ +// +// NSButton+Kingfisher.swift +// Kingfisher +// +// Created by Jie Zhang on 14/04/2016. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) + +import AppKit + +extension KingfisherWrapper where Base: NSButton { + + // MARK: Setting Image + + /// Sets an image to the button with a source. + /// + /// - Parameters: + /// - source: The `Source` object contains information about how to get the image. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// Internally, this method will use `KingfisherManager` to get the requested source. + /// Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setImage( + with: source, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + /// Sets an image to the button with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the resource. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with resource: Resource?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: resource?.convertToSource(), + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var mutatingSelf = self + guard let source = source else { + base.image = placeholder + mutatingSelf.taskIdentifier = nil + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + base.image = placeholder + } + + let issuedIdentifier = Source.Identifier.next() + mutatingSelf.taskIdentifier = issuedIdentifier + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.imageTask = $0 }, + progressiveImageSetter: { self.base.image = $0 }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.taskIdentifier }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.taskIdentifier else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.imageTask = nil + mutatingSelf.taskIdentifier = nil + + switch result { + case .success(let value): + self.base.image = value.image + completionHandler?(result) + + case .failure: + if let image = options.onFailureImage { + self.base.image = image + } + completionHandler?(result) + } + } + } + ) + + mutatingSelf.imageTask = task + return task + } + + // MARK: Cancelling Downloading Task + + /// Cancels the image download task of the button if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelImageDownloadTask() { + imageTask?.cancel() + } + + // MARK: Setting Alternate Image + + @discardableResult + public func setAlternateImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setAlternateImage( + with: source, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + /// Sets an alternate image to the button with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the resource. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setAlternateImage( + with resource: Resource?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setAlternateImage( + with: resource?.convertToSource(), + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + func setAlternateImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var mutatingSelf = self + guard let source = source else { + base.alternateImage = placeholder + mutatingSelf.alternateTaskIdentifier = nil + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + base.alternateImage = placeholder + } + + let issuedIdentifier = Source.Identifier.next() + mutatingSelf.alternateTaskIdentifier = issuedIdentifier + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + if let provider = ImageProgressiveProvider(options, refresh: { image in + self.base.alternateImage = image + }) { + options.onDataReceived = (options.onDataReceived ?? []) + [provider] + } + + options.onDataReceived?.forEach { + $0.onShouldApply = { issuedIdentifier == self.alternateTaskIdentifier } + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.alternateImageTask = $0 }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.alternateTaskIdentifier else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.alternateImageTask = nil + mutatingSelf.alternateTaskIdentifier = nil + + switch result { + case .success(let value): + self.base.alternateImage = value.image + completionHandler?(result) + + case .failure: + if let image = options.onFailureImage { + self.base.alternateImage = image + } + completionHandler?(result) + } + } + } + ) + + mutatingSelf.alternateImageTask = task + return task + } + + // MARK: Cancelling Alternate Image Downloading Task + + /// Cancels the alternate image download task of the button if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelAlternateImageDownloadTask() { + alternateImageTask?.cancel() + } +} + + +// MARK: - Associated Object +private var taskIdentifierKey: Void? +private var imageTaskKey: Void? + +private var alternateTaskIdentifierKey: Void? +private var alternateImageTaskKey: Void? + +extension KingfisherWrapper where Base: NSButton { + + // MARK: Properties + + public private(set) var taskIdentifier: Source.Identifier.Value? { + get { + let box: Box? = getAssociatedObject(base, &taskIdentifierKey) + return box?.value + } + set { + let box = newValue.map { Box($0) } + setRetainedAssociatedObject(base, &taskIdentifierKey, box) + } + } + + private var imageTask: DownloadTask? { + get { return getAssociatedObject(base, &imageTaskKey) } + set { setRetainedAssociatedObject(base, &imageTaskKey, newValue)} + } + + public private(set) var alternateTaskIdentifier: Source.Identifier.Value? { + get { + let box: Box? = getAssociatedObject(base, &alternateTaskIdentifierKey) + return box?.value + } + set { + let box = newValue.map { Box($0) } + setRetainedAssociatedObject(base, &alternateTaskIdentifierKey, box) + } + } + + private var alternateImageTask: DownloadTask? { + get { return getAssociatedObject(base, &alternateImageTaskKey) } + set { setRetainedAssociatedObject(base, &alternateImageTaskKey, newValue)} + } +} +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Extensions/NSTextAttachment+Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/Extensions/NSTextAttachment+Kingfisher.swift new file mode 100644 index 0000000..23f627e --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Extensions/NSTextAttachment+Kingfisher.swift @@ -0,0 +1,271 @@ +// +// NSTextAttachment+Kingfisher.swift +// Kingfisher +// +// Created by Benjamin Briggs on 22/07/2019. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if !os(watchOS) + +#if os(macOS) +import AppKit +#else +import UIKit +#endif + +extension KingfisherWrapper where Base: NSTextAttachment { + + // MARK: Setting Image + + /// Sets an image to the text attachment with a source. + /// + /// - Parameters: + /// - source: The `Source` object defines data information from network or a data provider. + /// - attributedView: The owner of the attributed string which this `NSTextAttachment` is added. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested source + /// Since this method will perform UI changes, you must call it from the main thread. + /// + /// The retrieved image will be set to `NSTextAttachment.image` property. Because it is not an image view based + /// rendering, options related to view, such as `.transition`, are not supported. + /// + /// Kingfisher will call `setNeedsDisplay` on the `attributedView` when the image task done. It gives the view a + /// chance to render the attributed string again for displaying the downloaded image. For example, if you set an + /// attributed with this `NSTextAttachment` to a `UILabel` object, pass it as the `attributedView` parameter. + /// + /// Here is a typical use case: + /// + /// ```swift + /// let attributedText = NSMutableAttributedString(string: "Hello World") + /// let textAttachment = NSTextAttachment() + /// + /// textAttachment.kf.setImage( + /// with: URL(string: "https://onevcat.com/assets/images/avatar.jpg")!, + /// attributedView: label, + /// options: [ + /// .processor( + /// ResizingImageProcessor(referenceSize: .init(width: 30, height: 30)) + /// |> RoundCornerImageProcessor(cornerRadius: 15)) + /// ] + /// ) + /// attributedText.replaceCharacters(in: NSRange(), with: NSAttributedString(attachment: textAttachment)) + /// label.attributedText = attributedText + /// ``` + /// + @discardableResult + public func setImage( + with source: Source?, + attributedView: @autoclosure @escaping () -> KFCrossPlatformView, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setImage( + with: source, + attributedView: attributedView, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + /// Sets an image to the text attachment with a source. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the resource. + /// - attributedView: The owner of the attributed string which this `NSTextAttachment` is added. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested source + /// Since this method will perform UI changes, you must call it from the main thread. + /// + /// The retrieved image will be set to `NSTextAttachment.image` property. Because it is not an image view based + /// rendering, options related to view, such as `.transition`, are not supported. + /// + /// Kingfisher will call `setNeedsDisplay` on the `attributedView` when the image task done. It gives the view a + /// chance to render the attributed string again for displaying the downloaded image. For example, if you set an + /// attributed with this `NSTextAttachment` to a `UILabel` object, pass it as the `attributedView` parameter. + /// + /// Here is a typical use case: + /// + /// ```swift + /// let attributedText = NSMutableAttributedString(string: "Hello World") + /// let textAttachment = NSTextAttachment() + /// + /// textAttachment.kf.setImage( + /// with: URL(string: "https://onevcat.com/assets/images/avatar.jpg")!, + /// attributedView: label, + /// options: [ + /// .processor( + /// ResizingImageProcessor(referenceSize: .init(width: 30, height: 30)) + /// |> RoundCornerImageProcessor(cornerRadius: 15)) + /// ] + /// ) + /// attributedText.replaceCharacters(in: NSRange(), with: NSAttributedString(attachment: textAttachment)) + /// label.attributedText = attributedText + /// ``` + /// + @discardableResult + public func setImage( + with resource: Resource?, + attributedView: @autoclosure @escaping () -> KFCrossPlatformView, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setImage( + with: resource.map { .network($0) }, + attributedView: attributedView, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + func setImage( + with source: Source?, + attributedView: @escaping () -> KFCrossPlatformView, + placeholder: KFCrossPlatformImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var mutatingSelf = self + guard let source = source else { + base.image = placeholder + mutatingSelf.taskIdentifier = nil + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + base.image = placeholder + } + + let issuedIdentifier = Source.Identifier.next() + mutatingSelf.taskIdentifier = issuedIdentifier + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + progressiveImageSetter: { self.base.image = $0 }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.taskIdentifier }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.taskIdentifier else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.imageTask = nil + mutatingSelf.taskIdentifier = nil + + switch result { + case .success(let value): + self.base.image = value.image + let view = attributedView() + #if canImport(UIKit) + view.setNeedsDisplay() + #else + view.setNeedsDisplay(view.bounds) + #endif + case .failure: + if let image = options.onFailureImage { + self.base.image = image + } + } + completionHandler?(result) + } + } + ) + + mutatingSelf.imageTask = task + return task + } + + // MARK: Cancelling Image + + /// Cancel the image download task bounded to the text attachment if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelDownloadTask() { + imageTask?.cancel() + } +} + +private var taskIdentifierKey: Void? +private var imageTaskKey: Void? + +// MARK: Properties +extension KingfisherWrapper where Base: NSTextAttachment { + + public private(set) var taskIdentifier: Source.Identifier.Value? { + get { + let box: Box? = getAssociatedObject(base, &taskIdentifierKey) + return box?.value + } + set { + let box = newValue.map { Box($0) } + setRetainedAssociatedObject(base, &taskIdentifierKey, box) + } + } + + private var imageTask: DownloadTask? { + get { return getAssociatedObject(base, &imageTaskKey) } + set { setRetainedAssociatedObject(base, &imageTaskKey, newValue)} + } +} + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Extensions/TVMonogramView+Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/Extensions/TVMonogramView+Kingfisher.swift new file mode 100644 index 0000000..c0993cd --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Extensions/TVMonogramView+Kingfisher.swift @@ -0,0 +1,209 @@ +// +// TVMonogramView+Kingfisher.swift +// Kingfisher +// +// Created by Marvin Nazari on 2020-12-07. +// +// Copyright (c) 2020 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +#if canImport(TVUIKit) + +import TVUIKit + +@available(tvOS 12.0, *) +extension KingfisherWrapper where Base: TVMonogramView { + + // MARK: Setting Image + + /// Sets an image to the image view with a source. + /// + /// - Parameters: + /// - source: The `Source` object contains information about the image. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested source + /// Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setImage( + with: source, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var mutatingSelf = self + guard let source = source else { + base.image = placeholder + mutatingSelf.taskIdentifier = nil + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + base.image = placeholder + } + + let issuedIdentifier = Source.Identifier.next() + mutatingSelf.taskIdentifier = issuedIdentifier + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.imageTask = $0 }, + progressiveImageSetter: { self.base.image = $0 }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.taskIdentifier }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.taskIdentifier else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.imageTask = nil + mutatingSelf.taskIdentifier = nil + + switch result { + case .success(let value): + self.base.image = value.image + completionHandler?(result) + + case .failure: + if let image = options.onFailureImage { + self.base.image = image + } + completionHandler?(result) + } + } + } + ) + + mutatingSelf.imageTask = task + return task + } + + /// Sets an image to the image view with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the image. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with resource: Resource?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: resource?.convertToSource(), + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + // MARK: Cancelling Image + + /// Cancel the image download task bounded to the image view if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelDownloadTask() { + imageTask?.cancel() + } +} + +private var taskIdentifierKey: Void? +private var imageTaskKey: Void? + +// MARK: Properties +@available(tvOS 12.0, *) +extension KingfisherWrapper where Base: TVMonogramView { + + public private(set) var taskIdentifier: Source.Identifier.Value? { + get { + let box: Box? = getAssociatedObject(base, &taskIdentifierKey) + return box?.value + } + set { + let box = newValue.map { Box($0) } + setRetainedAssociatedObject(base, &taskIdentifierKey, box) + } + } + + private var imageTask: DownloadTask? { + get { return getAssociatedObject(base, &imageTaskKey) } + set { setRetainedAssociatedObject(base, &imageTaskKey, newValue)} + } +} + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Extensions/UIButton+Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/Extensions/UIButton+Kingfisher.swift new file mode 100644 index 0000000..d1e2dcb --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Extensions/UIButton+Kingfisher.swift @@ -0,0 +1,400 @@ +// +// UIButton+Kingfisher.swift +// Kingfisher +// +// Created by Wei Wang on 15/4/13. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if !os(watchOS) + +#if canImport(UIKit) +import UIKit + +extension KingfisherWrapper where Base: UIButton { + + // MARK: Setting Image + /// Sets an image to the button for a specified state with a source. + /// + /// - Parameters: + /// - source: The `Source` object contains information about the image. + /// - state: The button state to which the image should be set. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// Internally, this method will use `KingfisherManager` to get the requested source, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with source: Source?, + for state: UIControl.State, + placeholder: UIImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setImage( + with: source, + for: state, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + /// Sets an image to the button for a specified state with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the resource. + /// - state: The button state to which the image should be set. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with resource: Resource?, + for state: UIControl.State, + placeholder: UIImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: resource?.convertToSource(), + for: state, + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + @discardableResult + public func setImage( + with source: Source?, + for state: UIControl.State, + placeholder: UIImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + guard let source = source else { + base.setImage(placeholder, for: state) + setTaskIdentifier(nil, for: state) + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + base.setImage(placeholder, for: state) + } + + var mutatingSelf = self + let issuedIdentifier = Source.Identifier.next() + setTaskIdentifier(issuedIdentifier, for: state) + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.imageTask = $0 }, + progressiveImageSetter: { self.base.setImage($0, for: state) }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.taskIdentifier(for: state) }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.taskIdentifier(for: state) else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.imageTask = nil + mutatingSelf.setTaskIdentifier(nil, for: state) + + switch result { + case .success(let value): + self.base.setImage(value.image, for: state) + completionHandler?(result) + + case .failure: + if let image = options.onFailureImage { + self.base.setImage(image, for: state) + } + completionHandler?(result) + } + } + } + ) + + mutatingSelf.imageTask = task + return task + } + + // MARK: Cancelling Downloading Task + + /// Cancels the image download task of the button if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelImageDownloadTask() { + imageTask?.cancel() + } + + // MARK: Setting Background Image + + /// Sets a background image to the button for a specified state with a source. + /// + /// - Parameters: + /// - source: The `Source` object contains information about the image. + /// - state: The button state to which the image should be set. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// Internally, this method will use `KingfisherManager` to get the requested source + /// Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setBackgroundImage( + with source: Source?, + for state: UIControl.State, + placeholder: UIImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setBackgroundImage( + with: source, + for: state, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + /// Sets a background image to the button for a specified state with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the resource. + /// - state: The button state to which the image should be set. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setBackgroundImage( + with resource: Resource?, + for state: UIControl.State, + placeholder: UIImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setBackgroundImage( + with: resource?.convertToSource(), + for: state, + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + func setBackgroundImage( + with source: Source?, + for state: UIControl.State, + placeholder: UIImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + guard let source = source else { + base.setBackgroundImage(placeholder, for: state) + setBackgroundTaskIdentifier(nil, for: state) + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + base.setBackgroundImage(placeholder, for: state) + } + + var mutatingSelf = self + let issuedIdentifier = Source.Identifier.next() + setBackgroundTaskIdentifier(issuedIdentifier, for: state) + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.backgroundImageTask = $0 }, + progressiveImageSetter: { self.base.setBackgroundImage($0, for: state) }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.backgroundTaskIdentifier(for: state) }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.backgroundTaskIdentifier(for: state) else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.backgroundImageTask = nil + mutatingSelf.setBackgroundTaskIdentifier(nil, for: state) + + switch result { + case .success(let value): + self.base.setBackgroundImage(value.image, for: state) + completionHandler?(result) + + case .failure: + if let image = options.onFailureImage { + self.base.setBackgroundImage(image, for: state) + } + completionHandler?(result) + } + } + } + ) + + mutatingSelf.backgroundImageTask = task + return task + } + + // MARK: Cancelling Background Downloading Task + + /// Cancels the background image download task of the button if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelBackgroundImageDownloadTask() { + backgroundImageTask?.cancel() + } +} + +// MARK: - Associated Object +private var taskIdentifierKey: Void? +private var imageTaskKey: Void? + +// MARK: Properties +extension KingfisherWrapper where Base: UIButton { + + private typealias TaskIdentifier = Box<[UInt: Source.Identifier.Value]> + + public func taskIdentifier(for state: UIControl.State) -> Source.Identifier.Value? { + return taskIdentifierInfo.value[state.rawValue] + } + + private func setTaskIdentifier(_ identifier: Source.Identifier.Value?, for state: UIControl.State) { + taskIdentifierInfo.value[state.rawValue] = identifier + } + + private var taskIdentifierInfo: TaskIdentifier { + return getAssociatedObject(base, &taskIdentifierKey) ?? { + setRetainedAssociatedObject(base, &taskIdentifierKey, $0) + return $0 + } (TaskIdentifier([:])) + } + + private var imageTask: DownloadTask? { + get { return getAssociatedObject(base, &imageTaskKey) } + set { setRetainedAssociatedObject(base, &imageTaskKey, newValue)} + } +} + + +private var backgroundTaskIdentifierKey: Void? +private var backgroundImageTaskKey: Void? + +// MARK: Background Properties +extension KingfisherWrapper where Base: UIButton { + + public func backgroundTaskIdentifier(for state: UIControl.State) -> Source.Identifier.Value? { + return backgroundTaskIdentifierInfo.value[state.rawValue] + } + + private func setBackgroundTaskIdentifier(_ identifier: Source.Identifier.Value?, for state: UIControl.State) { + backgroundTaskIdentifierInfo.value[state.rawValue] = identifier + } + + private var backgroundTaskIdentifierInfo: TaskIdentifier { + return getAssociatedObject(base, &backgroundTaskIdentifierKey) ?? { + setRetainedAssociatedObject(base, &backgroundTaskIdentifierKey, $0) + return $0 + } (TaskIdentifier([:])) + } + + private var backgroundImageTask: DownloadTask? { + get { return getAssociatedObject(base, &backgroundImageTaskKey) } + mutating set { setRetainedAssociatedObject(base, &backgroundImageTaskKey, newValue) } + } +} +#endif + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Extensions/WKInterfaceImage+Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/Extensions/WKInterfaceImage+Kingfisher.swift new file mode 100644 index 0000000..a24feeb --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Extensions/WKInterfaceImage+Kingfisher.swift @@ -0,0 +1,204 @@ +// +// WKInterfaceImage+Kingfisher.swift +// Kingfisher +// +// Created by Rodrigo Borges Soares on 04/05/18. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(WatchKit) + +import WatchKit + +extension KingfisherWrapper where Base: WKInterfaceImage { + + // MARK: Setting Image + + /// Sets an image to the image view with a source. + /// + /// - Parameters: + /// - source: The `Source` object contains information about the image. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested source + /// Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + let options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions + (options ?? .empty)) + return setImage( + with: source, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: completionHandler + ) + } + + /// Sets an image to the image view with a requested resource. + /// + /// - Parameters: + /// - resource: The `Resource` object contains information about the image. + /// - placeholder: A placeholder to show while retrieving the image from the given `resource`. + /// - options: An options set to define image setting behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. + /// - completionHandler: Called when the image retrieved and set finished. + /// - Returns: A task represents the image downloading. + /// + /// - Note: + /// + /// Internally, this method will use `KingfisherManager` to get the requested resource, from either cache + /// or network. Since this method will perform UI changes, you must call it from the main thread. + /// Both `progressBlock` and `completionHandler` will be also executed in the main thread. + /// + @discardableResult + public func setImage( + with resource: Resource?, + placeholder: KFCrossPlatformImage? = nil, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + return setImage( + with: resource?.convertToSource(), + placeholder: placeholder, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + func setImage( + with source: Source?, + placeholder: KFCrossPlatformImage? = nil, + parsedOptions: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var mutatingSelf = self + guard let source = source else { + base.setImage(placeholder) + mutatingSelf.taskIdentifier = nil + completionHandler?(.failure(KingfisherError.imageSettingError(reason: .emptySource))) + return nil + } + + var options = parsedOptions + if !options.keepCurrentImageWhileLoading { + base.setImage(placeholder) + } + + let issuedIdentifier = Source.Identifier.next() + mutatingSelf.taskIdentifier = issuedIdentifier + + if let block = progressBlock { + options.onDataReceived = (options.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + + let task = KingfisherManager.shared.retrieveImage( + with: source, + options: options, + downloadTaskUpdated: { mutatingSelf.imageTask = $0 }, + progressiveImageSetter: { self.base.setImage($0) }, + referenceTaskIdentifierChecker: { issuedIdentifier == self.taskIdentifier }, + completionHandler: { result in + CallbackQueue.mainCurrentOrAsync.execute { + guard issuedIdentifier == self.taskIdentifier else { + let reason: KingfisherError.ImageSettingErrorReason + do { + let value = try result.get() + reason = .notCurrentSourceTask(result: value, error: nil, source: source) + } catch { + reason = .notCurrentSourceTask(result: nil, error: error, source: source) + } + let error = KingfisherError.imageSettingError(reason: reason) + completionHandler?(.failure(error)) + return + } + + mutatingSelf.imageTask = nil + mutatingSelf.taskIdentifier = nil + + switch result { + case .success(let value): + self.base.setImage(value.image) + completionHandler?(result) + + case .failure: + if let image = options.onFailureImage { + self.base.setImage(image) + } + completionHandler?(result) + } + } + } + ) + + mutatingSelf.imageTask = task + return task + } + + // MARK: Cancelling Image + + /// Cancel the image download task bounded to the image view if it is running. + /// Nothing will happen if the downloading has already finished. + public func cancelDownloadTask() { + imageTask?.cancel() + } +} + +private var taskIdentifierKey: Void? +private var imageTaskKey: Void? + +// MARK: Properties +extension KingfisherWrapper where Base: WKInterfaceImage { + + public private(set) var taskIdentifier: Source.Identifier.Value? { + get { + let box: Box? = getAssociatedObject(base, &taskIdentifierKey) + return box?.value + } + set { + let box = newValue.map { Box($0) } + setRetainedAssociatedObject(base, &taskIdentifierKey, box) + } + } + + private var imageTask: DownloadTask? { + get { return getAssociatedObject(base, &imageTaskKey) } + set { setRetainedAssociatedObject(base, &imageTaskKey, newValue)} + } +} +#endif diff --git a/Demo/Pods/Kingfisher/Sources/General/ImageSource/AVAssetImageDataProvider.swift b/Demo/Pods/Kingfisher/Sources/General/ImageSource/AVAssetImageDataProvider.swift new file mode 100644 index 0000000..d13023b --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/ImageSource/AVAssetImageDataProvider.swift @@ -0,0 +1,138 @@ +// +// AVAssetImageDataProvider.swift +// Kingfisher +// +// Created by onevcat on 2020/08/09. +// +// Copyright (c) 2020 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if !os(watchOS) + +import Foundation +import AVKit + +#if canImport(MobileCoreServices) +import MobileCoreServices +#else +import CoreServices +#endif + +/// A data provider to provide thumbnail data from a given AVKit asset. +public struct AVAssetImageDataProvider: ImageDataProvider { + + /// The possible error might be caused by the `AVAssetImageDataProvider`. + /// - userCancelled: The data provider process is cancelled. + /// - invalidImage: The retrieved image is invalid. + public enum AVAssetImageDataProviderError: Error { + case userCancelled + case invalidImage(_ image: CGImage?) + } + + /// The asset image generator bound to `self`. + public let assetImageGenerator: AVAssetImageGenerator + + /// The time at which the image should be generate in the asset. + public let time: CMTime + + private var internalKey: String { + return (assetImageGenerator.asset as? AVURLAsset)?.url.absoluteString ?? UUID().uuidString + } + + /// The cache key used by `self`. + public var cacheKey: String { + return "\(internalKey)_\(time.seconds)" + } + + /// Creates an asset image data provider. + /// - Parameters: + /// - assetImageGenerator: The asset image generator controls data providing behaviors. + /// - time: At which time in the asset the image should be generated. + public init(assetImageGenerator: AVAssetImageGenerator, time: CMTime) { + self.assetImageGenerator = assetImageGenerator + self.time = time + } + + /// Creates an asset image data provider. + /// - Parameters: + /// - assetURL: The URL of asset for providing image data. + /// - time: At which time in the asset the image should be generated. + /// + /// This method uses `assetURL` to create an `AVAssetImageGenerator` object and calls + /// the `init(assetImageGenerator:time:)` initializer. + /// + public init(assetURL: URL, time: CMTime) { + let asset = AVAsset(url: assetURL) + let generator = AVAssetImageGenerator(asset: asset) + generator.appliesPreferredTrackTransform = true + self.init(assetImageGenerator: generator, time: time) + } + + /// Creates an asset image data provider. + /// + /// - Parameters: + /// - assetURL: The URL of asset for providing image data. + /// - seconds: At which time in seconds in the asset the image should be generated. + /// + /// This method uses `assetURL` to create an `AVAssetImageGenerator` object, uses `seconds` to create a `CMTime`, + /// and calls the `init(assetImageGenerator:time:)` initializer. + /// + public init(assetURL: URL, seconds: TimeInterval) { + let time = CMTime(seconds: seconds, preferredTimescale: 600) + self.init(assetURL: assetURL, time: time) + } + + public func data(handler: @escaping (Result) -> Void) { + assetImageGenerator.generateCGImagesAsynchronously(forTimes: [NSValue(time: time)]) { + (requestedTime, image, imageTime, result, error) in + if let error = error { + handler(.failure(error)) + return + } + + if result == .cancelled { + handler(.failure(AVAssetImageDataProviderError.userCancelled)) + return + } + + guard let cgImage = image, let data = cgImage.jpegData else { + handler(.failure(AVAssetImageDataProviderError.invalidImage(image))) + return + } + + handler(.success(data)) + } + } +} + +extension CGImage { + var jpegData: Data? { + guard let mutableData = CFDataCreateMutable(nil, 0), + let destination = CGImageDestinationCreateWithData(mutableData, kUTTypeJPEG, 1, nil) + else { + return nil + } + CGImageDestinationAddImage(destination, self, nil) + guard CGImageDestinationFinalize(destination) else { return nil } + return mutableData as Data + } +} + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/General/ImageSource/ImageDataProvider.swift b/Demo/Pods/Kingfisher/Sources/General/ImageSource/ImageDataProvider.swift new file mode 100644 index 0000000..dd34150 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/ImageSource/ImageDataProvider.swift @@ -0,0 +1,190 @@ +// +// ImageDataProvider.swift +// Kingfisher +// +// Created by onevcat on 2018/11/13. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents a data provider to provide image data to Kingfisher when setting with +/// `Source.provider` source. Compared to `Source.network` member, it gives a chance +/// to load some image data in your own way, as long as you can provide the data +/// representation for the image. +public protocol ImageDataProvider { + + /// The key used in cache. + var cacheKey: String { get } + + /// Provides the data which represents image. Kingfisher uses the data you pass in the + /// handler to process images and caches it for later use. + /// + /// - Parameter handler: The handler you should call when you prepared your data. + /// If the data is loaded successfully, call the handler with + /// a `.success` with the data associated. Otherwise, call it + /// with a `.failure` and pass the error. + /// + /// - Note: + /// If the `handler` is called with a `.failure` with error, a `dataProviderError` of + /// `ImageSettingErrorReason` will be finally thrown out to you as the `KingfisherError` + /// from the framework. + func data(handler: @escaping (Result) -> Void) + + /// The content URL represents this provider, if exists. + var contentURL: URL? { get } +} + +public extension ImageDataProvider { + var contentURL: URL? { return nil } + func convertToSource() -> Source { + .provider(self) + } +} + +/// Represents an image data provider for loading from a local file URL on disk. +/// Uses this type for adding a disk image to Kingfisher. Compared to loading it +/// directly, you can get benefit of using Kingfisher's extension methods, as well +/// as applying `ImageProcessor`s and storing the image to `ImageCache` of Kingfisher. +public struct LocalFileImageDataProvider: ImageDataProvider { + + // MARK: Public Properties + + /// The file URL from which the image be loaded. + public let fileURL: URL + private let loadingQueue: ExecutionQueue + + // MARK: Initializers + + /// Creates an image data provider by supplying the target local file URL. + /// + /// - Parameters: + /// - fileURL: The file URL from which the image be loaded. + /// - cacheKey: The key is used for caching the image data. By default, + /// the `absoluteString` of `fileURL` is used. + /// - loadingQueue: The queue where the file loading should happen. By default, the dispatch queue of + /// `.global(qos: .userInitiated)` will be used. + public init( + fileURL: URL, + cacheKey: String? = nil, + loadingQueue: ExecutionQueue = .dispatch(DispatchQueue.global(qos: .userInitiated)) + ) { + self.fileURL = fileURL + self.cacheKey = cacheKey ?? fileURL.localFileCacheKey + self.loadingQueue = loadingQueue + } + + // MARK: Protocol Conforming + + /// The key used in cache. + public var cacheKey: String + + public func data(handler:@escaping (Result) -> Void) { + loadingQueue.execute { + handler(Result(catching: { try Data(contentsOf: fileURL) })) + } + } + + #if swift(>=5.5) + #if canImport(_Concurrency) + @available(iOS 13.0, macOS 10.15, tvOS 13.0, watchOS 6.0, *) + public var data: Data { + get async throws { + try await withCheckedThrowingContinuation { continuation in + loadingQueue.execute { + do { + let data = try Data(contentsOf: fileURL) + continuation.resume(returning: data) + } catch { + continuation.resume(throwing: error) + } + } + } + } + } + #endif + #endif + + /// The URL of the local file on the disk. + public var contentURL: URL? { + return fileURL + } +} + +/// Represents an image data provider for loading image from a given Base64 encoded string. +public struct Base64ImageDataProvider: ImageDataProvider { + + // MARK: Public Properties + /// The encoded Base64 string for the image. + public let base64String: String + + // MARK: Initializers + + /// Creates an image data provider by supplying the Base64 encoded string. + /// + /// - Parameters: + /// - base64String: The Base64 encoded string for an image. + /// - cacheKey: The key is used for caching the image data. You need a different key for any different image. + public init(base64String: String, cacheKey: String) { + self.base64String = base64String + self.cacheKey = cacheKey + } + + // MARK: Protocol Conforming + + /// The key used in cache. + public var cacheKey: String + + public func data(handler: (Result) -> Void) { + let data = Data(base64Encoded: base64String)! + handler(.success(data)) + } +} + +/// Represents an image data provider for a raw data object. +public struct RawImageDataProvider: ImageDataProvider { + + // MARK: Public Properties + + /// The raw data object to provide to Kingfisher image loader. + public let data: Data + + // MARK: Initializers + + /// Creates an image data provider by the given raw `data` value and a `cacheKey` be used in Kingfisher cache. + /// + /// - Parameters: + /// - data: The raw data reprensents an image. + /// - cacheKey: The key is used for caching the image data. You need a different key for any different image. + public init(data: Data, cacheKey: String) { + self.data = data + self.cacheKey = cacheKey + } + + // MARK: Protocol Conforming + + /// The key used in cache. + public var cacheKey: String + + public func data(handler: @escaping (Result) -> Void) { + handler(.success(data)) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/General/ImageSource/Resource.swift b/Demo/Pods/Kingfisher/Sources/General/ImageSource/Resource.swift new file mode 100644 index 0000000..1496f3d --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/ImageSource/Resource.swift @@ -0,0 +1,115 @@ +// +// Resource.swift +// Kingfisher +// +// Created by Wei Wang on 15/4/6. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents an image resource at a certain url and a given cache key. +/// Kingfisher will use a `Resource` to download a resource from network and cache it with the cache key when +/// using `Source.network` as its image setting source. +public protocol Resource { + + /// The key used in cache. + var cacheKey: String { get } + + /// The target image URL. + var downloadURL: URL { get } +} + +extension Resource { + + /// Converts `self` to a valid `Source` based on its `downloadURL` scheme. A `.provider` with + /// `LocalFileImageDataProvider` associated will be returned if the URL points to a local file. Otherwise, + /// `.network` is returned. + public func convertToSource(overrideCacheKey: String? = nil) -> Source { + let key = overrideCacheKey ?? cacheKey + return downloadURL.isFileURL ? + .provider(LocalFileImageDataProvider(fileURL: downloadURL, cacheKey: key)) : + .network(ImageResource(downloadURL: downloadURL, cacheKey: key)) + } +} + +/// ImageResource is a simple combination of `downloadURL` and `cacheKey`. +/// When passed to image view set methods, Kingfisher will try to download the target +/// image from the `downloadURL`, and then store it with the `cacheKey` as the key in cache. +public struct ImageResource: Resource { + + // MARK: - Initializers + + /// Creates an image resource. + /// + /// - Parameters: + /// - downloadURL: The target image URL from where the image can be downloaded. + /// - cacheKey: The cache key. If `nil`, Kingfisher will use the `absoluteString` of `downloadURL` as the key. + /// Default is `nil`. + public init(downloadURL: URL, cacheKey: String? = nil) { + self.downloadURL = downloadURL + self.cacheKey = cacheKey ?? downloadURL.cacheKey + } + + // MARK: Protocol Conforming + + /// The key used in cache. + public let cacheKey: String + + /// The target image URL. + public let downloadURL: URL +} + +/// URL conforms to `Resource` in Kingfisher. +/// The `absoluteString` of this URL is used as `cacheKey`. And the URL itself will be used as `downloadURL`. +/// If you need customize the url and/or cache key, use `ImageResource` instead. +extension URL: Resource { + public var cacheKey: String { return isFileURL ? localFileCacheKey : absoluteString } + public var downloadURL: URL { return self } +} + +extension URL { + static let localFileCacheKeyPrefix = "kingfisher.local.cacheKey" + + // The special version of cache key for a local file on disk. Every time the app is reinstalled on the disk, + // the system assigns a new container folder to hold the .app (and the extensions, .appex) folder. So the URL for + // the same image in bundle might be different. + // + // This getter only uses the fixed part in the URL (until the bundle name folder) to provide a stable cache key + // for the image under the same path inside the bundle. + // + // See #1825 (https://github.com/onevcat/Kingfisher/issues/1825) + var localFileCacheKey: String { + var validComponents: [String] = [] + for part in pathComponents.reversed() { + validComponents.append(part) + if part.hasSuffix(".app") || part.hasSuffix(".appex") { + break + } + } + let fixedPath = "\(Self.localFileCacheKeyPrefix)/\(validComponents.reversed().joined(separator: "/"))" + if let q = query { + return "\(fixedPath)?\(q)" + } else { + return fixedPath + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/General/ImageSource/Source.swift b/Demo/Pods/Kingfisher/Sources/General/ImageSource/Source.swift new file mode 100644 index 0000000..13622e4 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/ImageSource/Source.swift @@ -0,0 +1,116 @@ +// +// Source.swift +// Kingfisher +// +// Created by onevcat on 2018/11/17. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents an image setting source for Kingfisher methods. +/// +/// A `Source` value indicates the way how the target image can be retrieved and cached. +/// +/// - network: The target image should be got from network remotely. The associated `Resource` +/// value defines detail information like image URL and cache key. +/// - provider: The target image should be provided in a data format. Normally, it can be an image +/// from local storage or in any other encoding format (like Base64). +public enum Source { + + /// Represents the source task identifier when setting an image to a view with extension methods. + public enum Identifier { + + /// The underlying value type of source identifier. + public typealias Value = UInt + static var current: Value = 0 + static func next() -> Value { + current += 1 + return current + } + } + + // MARK: Member Cases + + /// The target image should be got from network remotely. The associated `Resource` + /// value defines detail information like image URL and cache key. + case network(Resource) + + /// The target image should be provided in a data format. Normally, it can be an image + /// from local storage or in any other encoding format (like Base64). + case provider(ImageDataProvider) + + // MARK: Getting Properties + + /// The cache key defined for this source value. + public var cacheKey: String { + switch self { + case .network(let resource): return resource.cacheKey + case .provider(let provider): return provider.cacheKey + } + } + + /// The URL defined for this source value. + /// + /// For a `.network` source, it is the `downloadURL` of associated `Resource` instance. + /// For a `.provider` value, it is always `nil`. + public var url: URL? { + switch self { + case .network(let resource): return resource.downloadURL + case .provider(let provider): return provider.contentURL + } + } +} + +extension Source: Hashable { + public static func == (lhs: Source, rhs: Source) -> Bool { + switch (lhs, rhs) { + case (.network(let r1), .network(let r2)): + return r1.cacheKey == r2.cacheKey && r1.downloadURL == r2.downloadURL + case (.provider(let p1), .provider(let p2)): + return p1.cacheKey == p2.cacheKey && p1.contentURL == p2.contentURL + case (.provider(_), .network(_)): + return false + case (.network(_), .provider(_)): + return false + } + } + + public func hash(into hasher: inout Hasher) { + switch self { + case .network(let r): + hasher.combine(r.cacheKey) + hasher.combine(r.downloadURL) + case .provider(let p): + hasher.combine(p.cacheKey) + hasher.combine(p.contentURL) + } + } +} + +extension Source { + var asResource: Resource? { + guard case .network(let resource) = self else { + return nil + } + return resource + } +} diff --git a/Demo/Pods/Kingfisher/Sources/General/KF.swift b/Demo/Pods/Kingfisher/Sources/General/KF.swift new file mode 100644 index 0000000..8f3f028 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/KF.swift @@ -0,0 +1,442 @@ +// +// KF.swift +// Kingfisher +// +// Created by onevcat on 2020/09/21. +// +// Copyright (c) 2020 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(UIKit) +import UIKit +#endif + +#if canImport(CarPlay) && !targetEnvironment(macCatalyst) +import CarPlay +#endif + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) +import AppKit +#endif + +#if canImport(WatchKit) +import WatchKit +#endif + +#if canImport(TVUIKit) +import TVUIKit +#endif + +/// A helper type to create image setting tasks in a builder pattern. +/// Use methods in this type to create a `KF.Builder` instance and configure image tasks there. +public enum KF { + + /// Creates a builder for a given `Source`. + /// - Parameter source: The `Source` object defines data information from network or a data provider. + /// - Returns: A `KF.Builder` for future configuration. After configuring the builder, call `set(to:)` + /// to start the image loading. + public static func source(_ source: Source?) -> KF.Builder { + Builder(source: source) + } + + /// Creates a builder for a given `Resource`. + /// - Parameter resource: The `Resource` object defines data information like key or URL. + /// - Returns: A `KF.Builder` for future configuration. After configuring the builder, call `set(to:)` + /// to start the image loading. + public static func resource(_ resource: Resource?) -> KF.Builder { + source(resource?.convertToSource()) + } + + /// Creates a builder for a given `URL` and an optional cache key. + /// - Parameters: + /// - url: The URL where the image should be downloaded. + /// - cacheKey: The key used to store the downloaded image in cache. + /// If `nil`, the `absoluteString` of `url` is used as the cache key. + /// - Returns: A `KF.Builder` for future configuration. After configuring the builder, call `set(to:)` + /// to start the image loading. + public static func url(_ url: URL?, cacheKey: String? = nil) -> KF.Builder { + source(url?.convertToSource(overrideCacheKey: cacheKey)) + } + + /// Creates a builder for a given `ImageDataProvider`. + /// - Parameter provider: The `ImageDataProvider` object contains information about the data. + /// - Returns: A `KF.Builder` for future configuration. After configuring the builder, call `set(to:)` + /// to start the image loading. + public static func dataProvider(_ provider: ImageDataProvider?) -> KF.Builder { + source(provider?.convertToSource()) + } + + /// Creates a builder for some given raw data and a cache key. + /// - Parameters: + /// - data: The data object from which the image should be created. + /// - cacheKey: The key used to store the downloaded image in cache. + /// - Returns: A `KF.Builder` for future configuration. After configuring the builder, call `set(to:)` + /// to start the image loading. + public static func data(_ data: Data?, cacheKey: String) -> KF.Builder { + if let data = data { + return dataProvider(RawImageDataProvider(data: data, cacheKey: cacheKey)) + } else { + return dataProvider(nil) + } + } +} + + +extension KF { + + /// A builder class to configure an image retrieving task and set it to a holder view or component. + public class Builder { + private let source: Source? + + #if os(watchOS) + private var placeholder: KFCrossPlatformImage? + #else + private var placeholder: Placeholder? + #endif + + public var options = KingfisherParsedOptionsInfo(KingfisherManager.shared.defaultOptions) + + public let onFailureDelegate = Delegate() + public let onSuccessDelegate = Delegate() + public let onProgressDelegate = Delegate<(Int64, Int64), Void>() + + init(source: Source?) { + self.source = source + } + + private var resultHandler: ((Result) -> Void)? { + { + switch $0 { + case .success(let result): + self.onSuccessDelegate(result) + case .failure(let error): + self.onFailureDelegate(error) + } + } + } + + private var progressBlock: DownloadProgressBlock { + { self.onProgressDelegate(($0, $1)) } + } + } +} + +extension KF.Builder { + #if !os(watchOS) + + /// Builds the image task request and sets it to an image view. + /// - Parameter imageView: The image view which loads the task and should be set with the image. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @discardableResult + public func set(to imageView: KFCrossPlatformImageView) -> DownloadTask? { + imageView.kf.setImage( + with: source, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + + /// Builds the image task request and sets it to an `NSTextAttachment` object. + /// - Parameters: + /// - attachment: The text attachment object which loads the task and should be set with the image. + /// - attributedView: The owner of the attributed string which this `NSTextAttachment` is added. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @discardableResult + public func set(to attachment: NSTextAttachment, attributedView: @autoclosure @escaping () -> KFCrossPlatformView) -> DownloadTask? { + let placeholderImage = placeholder as? KFCrossPlatformImage ?? nil + return attachment.kf.setImage( + with: source, + attributedView: attributedView, + placeholder: placeholderImage, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + + #if canImport(UIKit) + + /// Builds the image task request and sets it to a button. + /// - Parameters: + /// - button: The button which loads the task and should be set with the image. + /// - state: The button state to which the image should be set. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @discardableResult + public func set(to button: UIButton, for state: UIControl.State) -> DownloadTask? { + let placeholderImage = placeholder as? KFCrossPlatformImage ?? nil + return button.kf.setImage( + with: source, + for: state, + placeholder: placeholderImage, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + + /// Builds the image task request and sets it to the background image for a button. + /// - Parameters: + /// - button: The button which loads the task and should be set with the image. + /// - state: The button state to which the image should be set. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @discardableResult + public func setBackground(to button: UIButton, for state: UIControl.State) -> DownloadTask? { + let placeholderImage = placeholder as? KFCrossPlatformImage ?? nil + return button.kf.setBackgroundImage( + with: source, + for: state, + placeholder: placeholderImage, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + #endif // end of canImport(UIKit) + + #if canImport(CarPlay) && !targetEnvironment(macCatalyst) + + /// Builds the image task request and sets it to the image for a list item. + /// - Parameters: + /// - listItem: The list item which loads the task and should be set with the image. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @available(iOS 14.0, *) + @discardableResult + public func set(to listItem: CPListItem) -> DownloadTask? { + let placeholderImage = placeholder as? KFCrossPlatformImage ?? nil + return listItem.kf.setImage( + with: source, + placeholder: placeholderImage, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + + } + + #endif + + #if canImport(AppKit) && !targetEnvironment(macCatalyst) + /// Builds the image task request and sets it to a button. + /// - Parameter button: The button which loads the task and should be set with the image. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @discardableResult + public func set(to button: NSButton) -> DownloadTask? { + let placeholderImage = placeholder as? KFCrossPlatformImage ?? nil + return button.kf.setImage( + with: source, + placeholder: placeholderImage, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + + /// Builds the image task request and sets it to the alternative image for a button. + /// - Parameter button: The button which loads the task and should be set with the image. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @discardableResult + public func setAlternative(to button: NSButton) -> DownloadTask? { + let placeholderImage = placeholder as? KFCrossPlatformImage ?? nil + return button.kf.setAlternateImage( + with: source, + placeholder: placeholderImage, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + #endif // end of canImport(AppKit) + #endif // end of !os(watchOS) + + #if canImport(WatchKit) + /// Builds the image task request and sets it to a `WKInterfaceImage` object. + /// - Parameter interfaceImage: The watch interface image which loads the task and should be set with the image. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @discardableResult + public func set(to interfaceImage: WKInterfaceImage) -> DownloadTask? { + return interfaceImage.kf.setImage( + with: source, + placeholder: placeholder, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + #endif // end of canImport(WatchKit) + + #if canImport(TVUIKit) + /// Builds the image task request and sets it to a TV monogram view. + /// - Parameter monogramView: The monogram view which loads the task and should be set with the image. + /// - Returns: A task represents the image downloading, if initialized. + /// This value is `nil` if the image is being loaded from cache. + @available(tvOS 12.0, *) + @discardableResult + public func set(to monogramView: TVMonogramView) -> DownloadTask? { + let placeholderImage = placeholder as? KFCrossPlatformImage ?? nil + return monogramView.kf.setImage( + with: source, + placeholder: placeholderImage, + parsedOptions: options, + progressBlock: progressBlock, + completionHandler: resultHandler + ) + } + #endif // end of canImport(TVUIKit) +} + +#if !os(watchOS) +extension KF.Builder { + #if os(iOS) || os(tvOS) + + /// Sets a placeholder which is used while retrieving the image. + /// - Parameter placeholder: A placeholder to show while retrieving the image from its source. + /// - Returns: A `KF.Builder` with changes applied. + public func placeholder(_ placeholder: Placeholder?) -> Self { + self.placeholder = placeholder + return self + } + #endif + + /// Sets a placeholder image which is used while retrieving the image. + /// - Parameter placeholder: An image to show while retrieving the image from its source. + /// - Returns: A `KF.Builder` with changes applied. + public func placeholder(_ image: KFCrossPlatformImage?) -> Self { + self.placeholder = image + return self + } +} +#endif + +extension KF.Builder { + + #if os(iOS) || os(tvOS) + /// Sets the transition for the image task. + /// - Parameter transition: The desired transition effect when setting the image to image view. + /// - Returns: A `KF.Builder` with changes applied. + /// + /// Kingfisher will use the `transition` to animate the image in if it is downloaded from web. + /// The transition will not happen when the + /// image is retrieved from either memory or disk cache by default. If you need to do the transition even when + /// the image being retrieved from cache, also call `forceRefresh()` on the returned `KF.Builder`. + public func transition(_ transition: ImageTransition) -> Self { + options.transition = transition + return self + } + + /// Sets a fade transition for the image task. + /// - Parameter duration: The duration of the fade transition. + /// - Returns: A `KF.Builder` with changes applied. + /// + /// Kingfisher will use the fade transition to animate the image in if it is downloaded from web. + /// The transition will not happen when the + /// image is retrieved from either memory or disk cache by default. If you need to do the transition even when + /// the image being retrieved from cache, also call `forceRefresh()` on the returned `KF.Builder`. + public func fade(duration: TimeInterval) -> Self { + options.transition = .fade(duration) + return self + } + #endif + + /// Sets whether keeping the existing image of image view while setting another image to it. + /// - Parameter enabled: Whether the existing image should be kept. + /// - Returns: A `KF.Builder` with changes applied. + /// + /// By setting this option, the placeholder image parameter of image view extension method + /// will be ignored and the current image will be kept while loading or downloading the new image. + /// + public func keepCurrentImageWhileLoading(_ enabled: Bool = true) -> Self { + options.keepCurrentImageWhileLoading = enabled + return self + } + + /// Sets whether only the first frame from an animated image file should be loaded as a single image. + /// - Parameter enabled: Whether the only the first frame should be loaded. + /// - Returns: A `KF.Builder` with changes applied. + /// + /// Loading an animated images may take too much memory. It will be useful when you want to display a + /// static preview of the first frame from an animated image. + /// + /// This option will be ignored if the target image is not animated image data. + /// + public func onlyLoadFirstFrame(_ enabled: Bool = true) -> Self { + options.onlyLoadFirstFrame = enabled + return self + } + + /// Enables progressive image loading with a specified `ImageProgressive` setting to process the + /// progressive JPEG data and display it in a progressive way. + /// - Parameter progressive: The progressive settings which is used while loading. + /// - Returns: A `KF.Builder` with changes applied. + public func progressiveJPEG(_ progressive: ImageProgressive? = .init()) -> Self { + options.progressiveJPEG = progressive + return self + } +} + +// MARK: - Deprecated +extension KF.Builder { + /// Starts the loading process of `self` immediately. + /// + /// By default, a `KFImage` will not load its source until the `onAppear` is called. This is a lazily loading + /// behavior and provides better performance. However, when you refresh the view, the lazy loading also causes a + /// flickering since the loading does not happen immediately. Call this method if you want to start the load at once + /// could help avoiding the flickering, with some performance trade-off. + /// + /// - Deprecated: This is not necessary anymore since `@StateObject` is used for holding the image data. + /// It does nothing now and please just remove it. + /// + /// - Returns: The `Self` value with changes applied. + @available(*, deprecated, message: "This is not necessary anymore since `@StateObject` is used. It does nothing now and please just remove it.") + public func loadImmediately(_ start: Bool = true) -> Self { + return self + } +} + +// MARK: - Redirect Handler +extension KF { + + /// Represents the detail information when a task redirect happens. It is wrapping necessary information for a + /// `ImageDownloadRedirectHandler`. See that protocol for more information. + public struct RedirectPayload { + + /// The related session data task when the redirect happens. It is + /// the current `SessionDataTask` which triggers this redirect. + public let task: SessionDataTask + + /// The response received during redirection. + public let response: HTTPURLResponse + + /// The request for redirection which can be modified. + public let newRequest: URLRequest + + /// A closure for being called with modified request. + public let completionHandler: (URLRequest?) -> Void + } +} diff --git a/Demo/Pods/Kingfisher/Sources/General/KFOptionsSetter.swift b/Demo/Pods/Kingfisher/Sources/General/KFOptionsSetter.swift new file mode 100644 index 0000000..9a07753 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/KFOptionsSetter.swift @@ -0,0 +1,706 @@ +// +// KFOptionsSetter.swift +// Kingfisher +// +// Created by onevcat on 2020/12/22. +// +// Copyright (c) 2020 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import CoreGraphics + +public protocol KFOptionSetter { + var options: KingfisherParsedOptionsInfo { get nonmutating set } + + var onFailureDelegate: Delegate { get } + var onSuccessDelegate: Delegate { get } + var onProgressDelegate: Delegate<(Int64, Int64), Void> { get } + + var delegateObserver: AnyObject { get } +} + +extension KF.Builder: KFOptionSetter { + public var delegateObserver: AnyObject { self } +} + +// MARK: - Life cycles +extension KFOptionSetter { + /// Sets the progress block to current builder. + /// - Parameter block: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. If `block` is `nil`, the callback + /// will be reset. + /// - Returns: A `Self` value with changes applied. + public func onProgress(_ block: DownloadProgressBlock?) -> Self { + onProgressDelegate.delegate(on: delegateObserver) { (observer, result) in + block?(result.0, result.1) + } + return self + } + + /// Sets the the done block to current builder. + /// - Parameter block: Called when the image task successfully completes and the the image set is done. If `block` + /// is `nil`, the callback will be reset. + /// - Returns: A `KF.Builder` with changes applied. + public func onSuccess(_ block: ((RetrieveImageResult) -> Void)?) -> Self { + onSuccessDelegate.delegate(on: delegateObserver) { (observer, result) in + block?(result) + } + return self + } + + /// Sets the catch block to current builder. + /// - Parameter block: Called when an error happens during the image task. If `block` + /// is `nil`, the callback will be reset. + /// - Returns: A `KF.Builder` with changes applied. + public func onFailure(_ block: ((KingfisherError) -> Void)?) -> Self { + onFailureDelegate.delegate(on: delegateObserver) { (observer, error) in + block?(error) + } + return self + } +} + +// MARK: - Basic options settings. +extension KFOptionSetter { + /// Sets the target image cache for this task. + /// - Parameter cache: The target cache is about to be used for the task. + /// - Returns: A `Self` value with changes applied. + /// + /// Kingfisher will use the associated `ImageCache` object when handling related operations, + /// including trying to retrieve the cached images and store the downloaded image to it. + /// + public func targetCache(_ cache: ImageCache) -> Self { + options.targetCache = cache + return self + } + + /// Sets the target image cache to store the original downloaded image for this task. + /// - Parameter cache: The target cache is about to be used for storing the original downloaded image from the task. + /// - Returns: A `Self` value with changes applied. + /// + /// The `ImageCache` for storing and retrieving original images. If `originalCache` is + /// contained in the options, it will be preferred for storing and retrieving original images. + /// If there is no `.originalCache` in the options, `.targetCache` will be used to store original images. + /// + /// When using KingfisherManager to download and store an image, if `cacheOriginalImage` is + /// applied in the option, the original image will be stored to this `originalCache`. At the + /// same time, if a requested final image (with processor applied) cannot be found in `targetCache`, + /// Kingfisher will try to search the original image to check whether it is already there. If found, + /// it will be used and applied with the given processor. It is an optimization for not downloading + /// the same image for multiple times. + /// + public func originalCache(_ cache: ImageCache) -> Self { + options.originalCache = cache + return self + } + + /// Sets the downloader used to perform the image download task. + /// - Parameter downloader: The downloader which is about to be used for downloading. + /// - Returns: A `Self` value with changes applied. + /// + /// Kingfisher will use the set `ImageDownloader` object to download the requested images. + public func downloader(_ downloader: ImageDownloader) -> Self { + options.downloader = downloader + return self + } + + /// Sets the download priority for the image task. + /// - Parameter priority: The download priority of image download task. + /// - Returns: A `Self` value with changes applied. + /// + /// The `priority` value will be set as the priority of the image download task. The value for it should be + /// between 0.0~1.0. You can choose a value between `URLSessionTask.defaultPriority`, `URLSessionTask.lowPriority` + /// or `URLSessionTask.highPriority`. If this option not set, the default value (`URLSessionTask.defaultPriority`) + /// will be used. + public func downloadPriority(_ priority: Float) -> Self { + options.downloadPriority = priority + return self + } + + /// Sets whether Kingfisher should ignore the cache and try to start a download task for the image source. + /// - Parameter enabled: Enable the force refresh or not. + /// - Returns: A `Self` value with changes applied. + public func forceRefresh(_ enabled: Bool = true) -> Self { + options.forceRefresh = enabled + return self + } + + /// Sets whether Kingfisher should try to retrieve the image from memory cache first. If not found, it ignores the + /// disk cache and starts a download task for the image source. + /// - Parameter enabled: Enable the memory-only cache searching or not. + /// - Returns: A `Self` value with changes applied. + /// + /// This is useful when you want to display a changeable image behind the same url at the same app session, while + /// avoiding download it for multiple times. + public func fromMemoryCacheOrRefresh(_ enabled: Bool = true) -> Self { + options.fromMemoryCacheOrRefresh = enabled + return self + } + + /// Sets whether the image should only be cached in memory but not in disk. + /// - Parameter enabled: Whether the image should be only cache in memory or not. + /// - Returns: A `Self` value with changes applied. + public func cacheMemoryOnly(_ enabled: Bool = true) -> Self { + options.cacheMemoryOnly = enabled + return self + } + + /// Sets whether Kingfisher should wait for caching operation to be completed before calling the + /// `onSuccess` or `onFailure` block. + /// - Parameter enabled: Whether Kingfisher should wait for caching operation. + /// - Returns: A `Self` value with changes applied. + public func waitForCache(_ enabled: Bool = true) -> Self { + options.waitForCache = enabled + return self + } + + /// Sets whether Kingfisher should only try to retrieve the image from cache, but not from network. + /// - Parameter enabled: Whether Kingfisher should only try to retrieve the image from cache. + /// - Returns: A `Self` value with changes applied. + /// + /// If the image is not in cache, the image retrieving will fail with the + /// `KingfisherError.cacheError` with `.imageNotExisting` as its reason. + public func onlyFromCache(_ enabled: Bool = true) -> Self { + options.onlyFromCache = enabled + return self + } + + /// Sets whether the image should be decoded in a background thread before using. + /// - Parameter enabled: Whether the image should be decoded in a background thread before using. + /// - Returns: A `Self` value with changes applied. + /// + /// Setting to `true` will decode the downloaded image data and do a off-screen rendering to extract pixel + /// information in background. This can speed up display, but will cost more time and memory to prepare the image + /// for using. + public func backgroundDecode(_ enabled: Bool = true) -> Self { + options.backgroundDecode = enabled + return self + } + + /// Sets the callback queue which is used as the target queue of dispatch callbacks when retrieving images from + /// cache. If not set, Kingfisher will use main queue for callbacks. + /// - Parameter queue: The target queue which the cache retrieving callback will be invoked on. + /// - Returns: A `Self` value with changes applied. + /// + /// - Note: + /// This option does not affect the callbacks for UI related extension methods or `KFImage` result handlers. + /// You will always get the callbacks called from main queue. + public func callbackQueue(_ queue: CallbackQueue) -> Self { + options.callbackQueue = queue + return self + } + + /// Sets the scale factor value when converting retrieved data to an image. + /// - Parameter factor: The scale factor value. + /// - Returns: A `Self` value with changes applied. + /// + /// Specify the image scale, instead of your screen scale. You may need to set the correct scale when you dealing + /// with 2x or 3x retina images. Otherwise, Kingfisher will convert the data to image object at `scale` 1.0. + /// + public func scaleFactor(_ factor: CGFloat) -> Self { + options.scaleFactor = factor + return self + } + + /// Sets whether the original image should be cached even when the original image has been processed by any other + /// `ImageProcessor`s. + /// - Parameter enabled: Whether the original image should be cached. + /// - Returns: A `Self` value with changes applied. + /// + /// If set and an `ImageProcessor` is used, Kingfisher will try to cache both the final result and original + /// image. Kingfisher will have a chance to use the original image when another processor is applied to the same + /// resource, instead of downloading it again. You can use `.originalCache` to specify a cache or the original + /// images if necessary. + /// + /// The original image will be only cached to disk storage. + /// + public func cacheOriginalImage(_ enabled: Bool = true) -> Self { + options.cacheOriginalImage = enabled + return self + } + + /// Sets writing options for an original image on a first write + /// - Parameter writingOptions: Options to control the writing of data to a disk storage. + /// - Returns: A `Self` value with changes applied. + /// If set, options will be passed the store operation for a new files. + /// + /// This is useful if you want to implement file enctyption on first write - eg [.completeFileProtection] + /// + public func diskStoreWriteOptions(_ writingOptions: Data.WritingOptions) -> Self { + options.diskStoreWriteOptions = writingOptions + return self + } + + /// Sets whether the disk storage loading should happen in the same calling queue. + /// - Parameter enabled: Whether the disk storage loading should happen in the same calling queue. + /// - Returns: A `Self` value with changes applied. + /// + /// By default, disk storage file loading + /// happens in its own queue with an asynchronous dispatch behavior. Although it provides better non-blocking disk + /// loading performance, it also causes a flickering when you reload an image from disk, if the image view already + /// has an image set. + /// + /// Set this options will stop that flickering by keeping all loading in the same queue (typically the UI queue + /// if you are using Kingfisher's extension methods to set an image), with a tradeoff of loading performance. + /// + public func loadDiskFileSynchronously(_ enabled: Bool = true) -> Self { + options.loadDiskFileSynchronously = enabled + return self + } + + /// Sets a queue on which the image processing should happen. + /// - Parameter queue: The queue on which the image processing should happen. + /// - Returns: A `Self` value with changes applied. + /// + /// By default, Kingfisher uses a pre-defined serial + /// queue to process images. Use this option to change this behavior. For example, specify a `.mainCurrentOrAsync` + /// to let the image be processed in main queue to prevent a possible flickering (but with a possibility of + /// blocking the UI, especially if the processor needs a lot of time to run). + public func processingQueue(_ queue: CallbackQueue?) -> Self { + options.processingQueue = queue + return self + } + + /// Sets the alternative sources that will be used when loading of the original input `Source` fails. + /// - Parameter sources: The alternative sources will be used. + /// - Returns: A `Self` value with changes applied. + /// + /// Values of the `sources` array will be used to start a new image loading task if the previous task + /// fails due to an error. The image source loading process will stop as soon as a source is loaded successfully. + /// If all `sources` are used but the loading is still failing, an `imageSettingError` with + /// `alternativeSourcesExhausted` as its reason will be given out in the `catch` block. + /// + /// This is useful if you want to implement a fallback solution for setting image. + /// + /// User cancellation will not trigger the alternative source loading. + public func alternativeSources(_ sources: [Source]?) -> Self { + options.alternativeSources = sources + return self + } + + /// Sets a retry strategy that will be used when something gets wrong during the image retrieving. + /// - Parameter strategy: The provided strategy to define how the retrying should happen. + /// - Returns: A `Self` value with changes applied. + public func retry(_ strategy: RetryStrategy?) -> Self { + options.retryStrategy = strategy + return self + } + + /// Sets a retry strategy with a max retry count and retrying interval. + /// - Parameters: + /// - maxCount: The maximum count before the retry stops. + /// - interval: The time interval between each retry attempt. + /// - Returns: A `Self` value with changes applied. + /// + /// This defines the simplest retry strategy, which retry a failing request for several times, with some certain + /// interval between each time. For example, `.retry(maxCount: 3, interval: .second(3))` means attempt for at most + /// three times, and wait for 3 seconds if a previous retry attempt fails, then start a new attempt. + public func retry(maxCount: Int, interval: DelayRetryStrategy.Interval = .seconds(3)) -> Self { + let strategy = DelayRetryStrategy(maxRetryCount: maxCount, retryInterval: interval) + options.retryStrategy = strategy + return self + } + + /// Sets the `Source` should be loaded when user enables Low Data Mode and the original source fails with an + /// `NSURLErrorNetworkUnavailableReason.constrained` error. + /// - Parameter source: The `Source` will be loaded under low data mode. + /// - Returns: A `Self` value with changes applied. + /// + /// When this option is set, the + /// `allowsConstrainedNetworkAccess` property of the request for the original source will be set to `false` and the + /// `Source` in associated value will be used to retrieve the image for low data mode. Usually, you can provide a + /// low-resolution version of your image or a local image provider to display a placeholder. + /// + /// If not set or the `source` is `nil`, the device Low Data Mode will be ignored and the original source will + /// be loaded following the system default behavior, in a normal way. + public func lowDataModeSource(_ source: Source?) -> Self { + options.lowDataModeSource = source + return self + } + + /// Sets whether the image setting for an image view should happen with transition even when retrieved from cache. + /// - Parameter enabled: Enable the force transition or not. + /// - Returns: A `Self` with changes applied. + public func forceTransition(_ enabled: Bool = true) -> Self { + options.forceTransition = enabled + return self + } + + /// Sets the image that will be used if an image retrieving task fails. + /// - Parameter image: The image that will be used when something goes wrong. + /// - Returns: A `Self` with changes applied. + /// + /// If set and an image retrieving error occurred Kingfisher will set provided image (or empty) + /// in place of requested one. It's useful when you don't want to show placeholder + /// during loading time but wants to use some default image when requests will be failed. + /// + public func onFailureImage(_ image: KFCrossPlatformImage?) -> Self { + options.onFailureImage = .some(image) + return self + } +} + +// MARK: - Request Modifier +extension KFOptionSetter { + /// Sets an `ImageDownloadRequestModifier` to change the image download request before it being sent. + /// - Parameter modifier: The modifier will be used to change the request before it being sent. + /// - Returns: A `Self` value with changes applied. + /// + /// This is the last chance you can modify the image download request. You can modify the request for some + /// customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url mapping. + /// + public func requestModifier(_ modifier: AsyncImageDownloadRequestModifier) -> Self { + options.requestModifier = modifier + return self + } + + /// Sets a block to change the image download request before it being sent. + /// - Parameter modifyBlock: The modifying block will be called to change the request before it being sent. + /// - Returns: A `Self` value with changes applied. + /// + /// This is the last chance you can modify the image download request. You can modify the request for some + /// customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url mapping. + /// + public func requestModifier(_ modifyBlock: @escaping (inout URLRequest) -> Void) -> Self { + options.requestModifier = AnyModifier { r -> URLRequest? in + var request = r + modifyBlock(&request) + return request + } + return self + } +} + +// MARK: - Redirect Handler +extension KFOptionSetter { + /// The `ImageDownloadRedirectHandler` argument will be used to change the request before redirection. + /// This is the possibility you can modify the image download request during redirect. You can modify the request for + /// some customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url + /// mapping. + /// The original redirection request will be sent without any modification by default. + /// - Parameter handler: The handler will be used for redirection. + /// - Returns: A `Self` value with changes applied. + public func redirectHandler(_ handler: ImageDownloadRedirectHandler) -> Self { + options.redirectHandler = handler + return self + } + + /// The `block` will be used to change the request before redirection. + /// This is the possibility you can modify the image download request during redirect. You can modify the request for + /// some customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url + /// mapping. + /// The original redirection request will be sent without any modification by default. + /// - Parameter block: The block will be used for redirection. + /// - Returns: A `Self` value with changes applied. + public func redirectHandler(_ block: @escaping (KF.RedirectPayload) -> Void) -> Self { + let redirectHandler = AnyRedirectHandler { (task, response, request, handler) in + let payload = KF.RedirectPayload( + task: task, response: response, newRequest: request, completionHandler: handler + ) + block(payload) + } + options.redirectHandler = redirectHandler + return self + } +} + +// MARK: - Processor +extension KFOptionSetter { + + /// Sets an image processor for the image task. It replaces the current image processor settings. + /// + /// - Parameter processor: The processor you want to use to process the image after it is downloaded. + /// - Returns: A `Self` value with changes applied. + /// + /// - Note: + /// To append a processor to current ones instead of replacing them all, use `appendProcessor(_:)`. + public func setProcessor(_ processor: ImageProcessor) -> Self { + options.processor = processor + return self + } + + /// Sets an array of image processors for the image task. It replaces the current image processor settings. + /// - Parameter processors: An array of processors. The processors inside this array will be concatenated one by one + /// to form a processor pipeline. + /// - Returns: A `Self` value with changes applied. + /// + /// - Note: To append processors to current ones instead of replacing them all, concatenate them by `|>`, then use + /// `appendProcessor(_:)`. + public func setProcessors(_ processors: [ImageProcessor]) -> Self { + switch processors.count { + case 0: + options.processor = DefaultImageProcessor.default + case 1...: + options.processor = processors.dropFirst().reduce(processors[0]) { $0 |> $1 } + default: + assertionFailure("Never happen") + } + return self + } + + /// Appends a processor to the current set processors. + /// - Parameter processor: The processor which will be appended to current processor settings. + /// - Returns: A `Self` value with changes applied. + public func appendProcessor(_ processor: ImageProcessor) -> Self { + options.processor = options.processor |> processor + return self + } + + /// Appends a `RoundCornerImageProcessor` to current processors. + /// - Parameters: + /// - radius: The radius will be applied in processing. Specify a certain point value with `.point`, or a fraction + /// of the target image with `.widthFraction`. or `.heightFraction`. For example, given a square image + /// with width and height equals, `.widthFraction(0.5)` means use half of the length of size and makes + /// the final image a round one. + /// - targetSize: Target size of output image should be. If `nil`, the image will keep its original size after processing. + /// - corners: The target corners which will be applied rounding. + /// - backgroundColor: Background color of the output image. If `nil`, it will use a transparent background. + /// - Returns: A `Self` value with changes applied. + public func roundCorner( + radius: Radius, + targetSize: CGSize? = nil, + roundingCorners corners: RectCorner = .all, + backgroundColor: KFCrossPlatformColor? = nil + ) -> Self + { + let processor = RoundCornerImageProcessor( + radius: radius, + targetSize: targetSize, + roundingCorners: corners, + backgroundColor: backgroundColor + ) + return appendProcessor(processor) + } + + /// Appends a `BlurImageProcessor` to current processors. + /// - Parameter radius: Blur radius for the simulated Gaussian blur. + /// - Returns: A `Self` value with changes applied. + public func blur(radius: CGFloat) -> Self { + appendProcessor( + BlurImageProcessor(blurRadius: radius) + ) + } + + /// Appends a `OverlayImageProcessor` to current processors. + /// - Parameters: + /// - color: Overlay color will be used to overlay the input image. + /// - fraction: Fraction will be used when overlay the color to image. + /// - Returns: A `Self` value with changes applied. + public func overlay(color: KFCrossPlatformColor, fraction: CGFloat = 0.5) -> Self { + appendProcessor( + OverlayImageProcessor(overlay: color, fraction: fraction) + ) + } + + /// Appends a `TintImageProcessor` to current processors. + /// - Parameter color: Tint color will be used to tint the input image. + /// - Returns: A `Self` value with changes applied. + public func tint(color: KFCrossPlatformColor) -> Self { + appendProcessor( + TintImageProcessor(tint: color) + ) + } + + /// Appends a `BlackWhiteProcessor` to current processors. + /// - Returns: A `Self` value with changes applied. + public func blackWhite() -> Self { + appendProcessor( + BlackWhiteProcessor() + ) + } + + /// Appends a `CroppingImageProcessor` to current processors. + /// - Parameters: + /// - size: Target size of output image should be. + /// - anchor: Anchor point from which the output size should be calculate. The anchor point is consisted by two + /// values between 0.0 and 1.0. It indicates a related point in current image. + /// See `CroppingImageProcessor.init(size:anchor:)` for more. + /// - Returns: A `Self` value with changes applied. + public func cropping(size: CGSize, anchor: CGPoint = .init(x: 0.5, y: 0.5)) -> Self { + appendProcessor( + CroppingImageProcessor(size: size, anchor: anchor) + ) + } + + /// Appends a `DownsamplingImageProcessor` to current processors. + /// + /// Compared to `ResizingImageProcessor`, the `DownsamplingImageProcessor` does not render the original images and + /// then resize it. Instead, it downsamples the input data directly to a thumbnail image. So it is a more efficient + /// than `ResizingImageProcessor`. Prefer to use `DownsamplingImageProcessor` as possible + /// as you can than the `ResizingImageProcessor`. + /// + /// Only CG-based images are supported. Animated images (like GIF) is not supported. + /// + /// - Parameter size: Target size of output image should be. It should be smaller than the size of input image. + /// If it is larger, the result image will be the same size of input data without downsampling. + /// - Returns: A `Self` value with changes applied. + public func downsampling(size: CGSize) -> Self { + let processor = DownsamplingImageProcessor(size: size) + if options.processor == DefaultImageProcessor.default { + return setProcessor(processor) + } else { + return appendProcessor(processor) + } + } + + + /// Appends a `ResizingImageProcessor` to current processors. + /// + /// If you need to resize a data represented image to a smaller size, use `DownsamplingImageProcessor` + /// instead, which is more efficient and uses less memory. + /// + /// - Parameters: + /// - referenceSize: The reference size for resizing operation in point. + /// - mode: Target content mode of output image should be. Default is `.none`. + /// - Returns: A `Self` value with changes applied. + public func resizing(referenceSize: CGSize, mode: ContentMode = .none) -> Self { + appendProcessor( + ResizingImageProcessor(referenceSize: referenceSize, mode: mode) + ) + } +} + +// MARK: - Cache Serializer +extension KFOptionSetter { + + /// Uses a given `CacheSerializer` to convert some data to an image object for retrieving from disk cache or vice + /// versa for storing to disk cache. + /// - Parameter cacheSerializer: The `CacheSerializer` which will be used. + /// - Returns: A `Self` value with changes applied. + public func serialize(by cacheSerializer: CacheSerializer) -> Self { + options.cacheSerializer = cacheSerializer + return self + } + + /// Uses a given format to serializer the image data to disk. It converts the image object to the give data format. + /// - Parameters: + /// - format: The desired data encoding format when store the image on disk. + /// - jpegCompressionQuality: If the format is `.JPEG`, it specify the compression quality when converting the + /// image to a JPEG data. Otherwise, it is ignored. + /// - Returns: A `Self` value with changes applied. + public func serialize(as format: ImageFormat, jpegCompressionQuality: CGFloat? = nil) -> Self { + let cacheSerializer: FormatIndicatedCacheSerializer + switch format { + case .JPEG: + cacheSerializer = .jpeg(compressionQuality: jpegCompressionQuality ?? 1.0) + case .PNG: + cacheSerializer = .png + case .GIF: + cacheSerializer = .gif + case .unknown: + cacheSerializer = .png + } + options.cacheSerializer = cacheSerializer + return self + } +} + +// MARK: - Image Modifier +extension KFOptionSetter { + + /// Sets an `ImageModifier` to the image task. Use this to modify the fetched image object properties if needed. + /// + /// If the image was fetched directly from the downloader, the modifier will run directly after the + /// `ImageProcessor`. If the image is being fetched from a cache, the modifier will run after the `CacheSerializer`. + /// - Parameter modifier: The `ImageModifier` which will be used to modify the image object. + /// - Returns: A `Self` value with changes applied. + public func imageModifier(_ modifier: ImageModifier?) -> Self { + options.imageModifier = modifier + return self + } + + /// Sets a block to modify the image object. Use this to modify the fetched image object properties if needed. + /// + /// If the image was fetched directly from the downloader, the modifier block will run directly after the + /// `ImageProcessor`. If the image is being fetched from a cache, the modifier will run after the `CacheSerializer`. + /// + /// - Parameter block: The block which is used to modify the image object. + /// - Returns: A `Self` value with changes applied. + public func imageModifier(_ block: @escaping (inout KFCrossPlatformImage) throws -> Void) -> Self { + let modifier = AnyImageModifier { image -> KFCrossPlatformImage in + var image = image + try block(&image) + return image + } + options.imageModifier = modifier + return self + } +} + + +// MARK: - Cache Expiration +extension KFOptionSetter { + + /// Sets the expiration setting for memory cache of this image task. + /// + /// By default, the underlying `MemoryStorage.Backend` uses the + /// expiration in its config for all items. If set, the `MemoryStorage.Backend` will use this value to overwrite + /// the config setting for this caching item. + /// + /// - Parameter expiration: The expiration setting used in cache storage. + /// - Returns: A `Self` value with changes applied. + public func memoryCacheExpiration(_ expiration: StorageExpiration?) -> Self { + options.memoryCacheExpiration = expiration + return self + } + + /// Sets the expiration extending setting for memory cache. The item expiration time will be incremented by this + /// value after access. + /// + /// By default, the underlying `MemoryStorage.Backend` uses the initial cache expiration as extending + /// value: .cacheTime. + /// + /// To disable extending option at all, sets `.none` to it. + /// + /// - Parameter extending: The expiration extending setting used in cache storage. + /// - Returns: A `Self` value with changes applied. + public func memoryCacheAccessExtending(_ extending: ExpirationExtending) -> Self { + options.memoryCacheAccessExtendingExpiration = extending + return self + } + + /// Sets the expiration setting for disk cache of this image task. + /// + /// By default, the underlying `DiskStorage.Backend` uses the expiration in its config for all items. If set, + /// the `DiskStorage.Backend` will use this value to overwrite the config setting for this caching item. + /// + /// - Parameter expiration: The expiration setting used in cache storage. + /// - Returns: A `Self` value with changes applied. + public func diskCacheExpiration(_ expiration: StorageExpiration?) -> Self { + options.diskCacheExpiration = expiration + return self + } + + /// Sets the expiration extending setting for disk cache. The item expiration time will be incremented by this + /// value after access. + /// + /// By default, the underlying `DiskStorage.Backend` uses the initial cache expiration as extending + /// value: .cacheTime. + /// + /// To disable extending option at all, sets `.none` to it. + /// + /// - Parameter extending: The expiration extending setting used in cache storage. + /// - Returns: A `Self` value with changes applied. + public func diskCacheAccessExtending(_ extending: ExpirationExtending) -> Self { + options.diskCacheAccessExtendingExpiration = extending + return self + } +} diff --git a/Demo/Pods/Kingfisher/Sources/General/Kingfisher.swift b/Demo/Pods/Kingfisher/Sources/General/Kingfisher.swift new file mode 100644 index 0000000..f875e2a --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/Kingfisher.swift @@ -0,0 +1,106 @@ +// +// Kingfisher.swift +// Kingfisher +// +// Created by Wei Wang on 16/9/14. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import ImageIO + +#if os(macOS) +import AppKit +public typealias KFCrossPlatformImage = NSImage +public typealias KFCrossPlatformView = NSView +public typealias KFCrossPlatformColor = NSColor +public typealias KFCrossPlatformImageView = NSImageView +public typealias KFCrossPlatformButton = NSButton +#else +import UIKit +public typealias KFCrossPlatformImage = UIImage +public typealias KFCrossPlatformColor = UIColor +#if !os(watchOS) +public typealias KFCrossPlatformImageView = UIImageView +public typealias KFCrossPlatformView = UIView +public typealias KFCrossPlatformButton = UIButton +#if canImport(TVUIKit) +import TVUIKit +#endif +#if canImport(CarPlay) && !targetEnvironment(macCatalyst) +import CarPlay +#endif +#else +import WatchKit +#endif +#endif + +/// Wrapper for Kingfisher compatible types. This type provides an extension point for +/// convenience methods in Kingfisher. +public struct KingfisherWrapper { + public let base: Base + public init(_ base: Base) { + self.base = base + } +} + +/// Represents an object type that is compatible with Kingfisher. You can use `kf` property to get a +/// value in the namespace of Kingfisher. +public protocol KingfisherCompatible: AnyObject { } + +/// Represents a value type that is compatible with Kingfisher. You can use `kf` property to get a +/// value in the namespace of Kingfisher. +public protocol KingfisherCompatibleValue {} + +extension KingfisherCompatible { + /// Gets a namespace holder for Kingfisher compatible types. + public var kf: KingfisherWrapper { + get { return KingfisherWrapper(self) } + set { } + } +} + +extension KingfisherCompatibleValue { + /// Gets a namespace holder for Kingfisher compatible types. + public var kf: KingfisherWrapper { + get { return KingfisherWrapper(self) } + set { } + } +} + +extension KFCrossPlatformImage: KingfisherCompatible { } +#if !os(watchOS) +extension KFCrossPlatformImageView: KingfisherCompatible { } +extension KFCrossPlatformButton: KingfisherCompatible { } +extension NSTextAttachment: KingfisherCompatible { } +#else +extension WKInterfaceImage: KingfisherCompatible { } +#endif + +#if os(tvOS) && canImport(TVUIKit) +@available(tvOS 12.0, *) +extension TVMonogramView: KingfisherCompatible { } +#endif + +#if canImport(CarPlay) && !targetEnvironment(macCatalyst) +@available(iOS 14.0, *) +extension CPListItem: KingfisherCompatible { } +#endif diff --git a/Demo/Pods/Kingfisher/Sources/General/KingfisherError.swift b/Demo/Pods/Kingfisher/Sources/General/KingfisherError.swift new file mode 100644 index 0000000..83d20a1 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/KingfisherError.swift @@ -0,0 +1,461 @@ +// +// KingfisherError.swift +// Kingfisher +// +// Created by onevcat on 2018/09/26. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +extension Never {} + +/// Represents all the errors which can happen in Kingfisher framework. +/// Kingfisher related methods always throw a `KingfisherError` or invoke the callback with `KingfisherError` +/// as its error type. To handle errors from Kingfisher, you switch over the error to get a reason catalog, +/// then switch over the reason to know error detail. +public enum KingfisherError: Error { + + // MARK: Error Reason Types + + /// Represents the error reason during networking request phase. + /// + /// - emptyRequest: The request is empty. Code 1001. + /// - invalidURL: The URL of request is invalid. Code 1002. + /// - taskCancelled: The downloading task is cancelled by user. Code 1003. + public enum RequestErrorReason { + + /// The request is empty. Code 1001. + case emptyRequest + + /// The URL of request is invalid. Code 1002. + /// - request: The request is tend to be sent but its URL is invalid. + case invalidURL(request: URLRequest) + + /// The downloading task is cancelled by user. Code 1003. + /// - task: The session data task which is cancelled. + /// - token: The cancel token which is used for cancelling the task. + case taskCancelled(task: SessionDataTask, token: SessionDataTask.CancelToken) + } + + /// Represents the error reason during networking response phase. + /// + /// - invalidURLResponse: The response is not a valid URL response. Code 2001. + /// - invalidHTTPStatusCode: The response contains an invalid HTTP status code. Code 2002. + /// - URLSessionError: An error happens in the system URL session. Code 2003. + /// - dataModifyingFailed: Data modifying fails on returning a valid data. Code 2004. + /// - noURLResponse: The task is done but no URL response found. Code 2005. + public enum ResponseErrorReason { + + /// The response is not a valid URL response. Code 2001. + /// - response: The received invalid URL response. + /// The response is expected to be an HTTP response, but it is not. + case invalidURLResponse(response: URLResponse) + + /// The response contains an invalid HTTP status code. Code 2002. + /// - Note: + /// By default, status code 200..<400 is recognized as valid. You can override + /// this behavior by conforming to the `ImageDownloaderDelegate`. + /// - response: The received response. + case invalidHTTPStatusCode(response: HTTPURLResponse) + + /// An error happens in the system URL session. Code 2003. + /// - error: The underlying URLSession error object. + case URLSessionError(error: Error) + + /// Data modifying fails on returning a valid data. Code 2004. + /// - task: The failed task. + case dataModifyingFailed(task: SessionDataTask) + + /// The task is done but no URL response found. Code 2005. + /// - task: The failed task. + case noURLResponse(task: SessionDataTask) + } + + /// Represents the error reason during Kingfisher caching system. + /// + /// - fileEnumeratorCreationFailed: Cannot create a file enumerator for a certain disk URL. Code 3001. + /// - invalidFileEnumeratorContent: Cannot get correct file contents from a file enumerator. Code 3002. + /// - invalidURLResource: The file at target URL exists, but its URL resource is unavailable. Code 3003. + /// - cannotLoadDataFromDisk: The file at target URL exists, but the data cannot be loaded from it. Code 3004. + /// - cannotCreateDirectory: Cannot create a folder at a given path. Code 3005. + /// - imageNotExisting: The requested image does not exist in cache. Code 3006. + /// - cannotConvertToData: Cannot convert an object to data for storing. Code 3007. + /// - cannotSerializeImage: Cannot serialize an image to data for storing. Code 3008. + /// - cannotCreateCacheFile: Cannot create the cache file at a certain fileURL under a key. Code 3009. + /// - cannotSetCacheFileAttribute: Cannot set file attributes to a cached file. Code 3010. + public enum CacheErrorReason { + + /// Cannot create a file enumerator for a certain disk URL. Code 3001. + /// - url: The target disk URL from which the file enumerator should be created. + case fileEnumeratorCreationFailed(url: URL) + + /// Cannot get correct file contents from a file enumerator. Code 3002. + /// - url: The target disk URL from which the content of a file enumerator should be got. + case invalidFileEnumeratorContent(url: URL) + + /// The file at target URL exists, but its URL resource is unavailable. Code 3003. + /// - error: The underlying error thrown by file manager. + /// - key: The key used to getting the resource from cache. + /// - url: The disk URL where the target cached file exists. + case invalidURLResource(error: Error, key: String, url: URL) + + /// The file at target URL exists, but the data cannot be loaded from it. Code 3004. + /// - url: The disk URL where the target cached file exists. + /// - error: The underlying error which describes why this error happens. + case cannotLoadDataFromDisk(url: URL, error: Error) + + /// Cannot create a folder at a given path. Code 3005. + /// - path: The disk path where the directory creating operation fails. + /// - error: The underlying error which describes why this error happens. + case cannotCreateDirectory(path: String, error: Error) + + /// The requested image does not exist in cache. Code 3006. + /// - key: Key of the requested image in cache. + case imageNotExisting(key: String) + + /// Cannot convert an object to data for storing. Code 3007. + /// - object: The object which needs be convert to data. + case cannotConvertToData(object: Any, error: Error) + + /// Cannot serialize an image to data for storing. Code 3008. + /// - image: The input image needs to be serialized to cache. + /// - original: The original image data, if exists. + /// - serializer: The `CacheSerializer` used for the image serializing. + case cannotSerializeImage(image: KFCrossPlatformImage?, original: Data?, serializer: CacheSerializer) + + /// Cannot create the cache file at a certain fileURL under a key. Code 3009. + /// - fileURL: The url where the cache file should be created. + /// - key: The cache key used for the cache. When caching a file through `KingfisherManager` and Kingfisher's + /// extension method, it is the resolved cache key based on your input `Source` and the image processors. + /// - data: The data to be cached. + /// - error: The underlying error originally thrown by Foundation when writing the `data` to the disk file at + /// `fileURL`. + case cannotCreateCacheFile(fileURL: URL, key: String, data: Data, error: Error) + + /// Cannot set file attributes to a cached file. Code 3010. + /// - filePath: The path of target cache file. + /// - attributes: The file attribute to be set to the target file. + /// - error: The underlying error originally thrown by Foundation when setting the `attributes` to the disk + /// file at `filePath`. + case cannotSetCacheFileAttribute(filePath: String, attributes: [FileAttributeKey : Any], error: Error) + + /// The disk storage of cache is not ready. Code 3011. + /// + /// This is usually due to extremely lack of space on disk storage, and + /// Kingfisher failed even when creating the cache folder. The disk storage will be in unusable state. Normally, + /// ask user to free some spaces and restart the app to make the disk storage work again. + /// - cacheURL: The intended URL which should be the storage folder. + case diskStorageIsNotReady(cacheURL: URL) + } + + + /// Represents the error reason during image processing phase. + /// + /// - processingFailed: Image processing fails. There is no valid output image from the processor. Code 4001. + public enum ProcessorErrorReason { + /// Image processing fails. There is no valid output image from the processor. Code 4001. + /// - processor: The `ImageProcessor` used to process the image or its data in `item`. + /// - item: The image or its data content. + case processingFailed(processor: ImageProcessor, item: ImageProcessItem) + } + + /// Represents the error reason during image setting in a view related class. + /// + /// - emptySource: The input resource is empty or `nil`. Code 5001. + /// - notCurrentSourceTask: The source task is finished, but it is not the one expected now. Code 5002. + /// - dataProviderError: An error happens during getting data from an `ImageDataProvider`. Code 5003. + public enum ImageSettingErrorReason { + + /// The input resource is empty or `nil`. Code 5001. + case emptySource + + /// The resource task is finished, but it is not the one expected now. This usually happens when you set another + /// resource on the view without cancelling the current on-going one. The previous setting task will fail with + /// this `.notCurrentSourceTask` error when a result got, regardless of it being successful or not for that task. + /// The result of this original task is contained in the associated value. + /// Code 5002. + /// - result: The `RetrieveImageResult` if the source task is finished without problem. `nil` if an error + /// happens. + /// - error: The `Error` if an issue happens during image setting task. `nil` if the task finishes without + /// problem. + /// - source: The original source value of the task. + case notCurrentSourceTask(result: RetrieveImageResult?, error: Error?, source: Source) + + /// An error happens during getting data from an `ImageDataProvider`. Code 5003. + case dataProviderError(provider: ImageDataProvider, error: Error) + + /// No more alternative `Source` can be used in current loading process. It means that the + /// `.alternativeSources` are used and Kingfisher tried to recovery from the original error, but still + /// fails for all the given alternative sources. The associated value holds all the errors encountered during + /// the load process, including the original source loading error and all the alternative sources errors. + /// Code 5004. + case alternativeSourcesExhausted([PropagationError]) + } + + // MARK: Member Cases + + /// Represents the error reason during networking request phase. + case requestError(reason: RequestErrorReason) + /// Represents the error reason during networking response phase. + case responseError(reason: ResponseErrorReason) + /// Represents the error reason during Kingfisher caching system. + case cacheError(reason: CacheErrorReason) + /// Represents the error reason during image processing phase. + case processorError(reason: ProcessorErrorReason) + /// Represents the error reason during image setting in a view related class. + case imageSettingError(reason: ImageSettingErrorReason) + + // MARK: Helper Properties & Methods + + /// Helper property to check whether this error is a `RequestErrorReason.taskCancelled` or not. + public var isTaskCancelled: Bool { + if case .requestError(reason: .taskCancelled) = self { + return true + } + return false + } + + /// Helper method to check whether this error is a `ResponseErrorReason.invalidHTTPStatusCode` and the + /// associated value is a given status code. + /// + /// - Parameter code: The given status code. + /// - Returns: If `self` is a `ResponseErrorReason.invalidHTTPStatusCode` error + /// and its status code equals to `code`, `true` is returned. Otherwise, `false`. + public func isInvalidResponseStatusCode(_ code: Int) -> Bool { + if case .responseError(reason: .invalidHTTPStatusCode(let response)) = self { + return response.statusCode == code + } + return false + } + + public var isInvalidResponseStatusCode: Bool { + if case .responseError(reason: .invalidHTTPStatusCode) = self { + return true + } + return false + } + + /// Helper property to check whether this error is a `ImageSettingErrorReason.notCurrentSourceTask` or not. + /// When a new image setting task starts while the old one is still running, the new task identifier will be + /// set and the old one is overwritten. A `.notCurrentSourceTask` error will be raised when the old task finishes + /// to let you know the setting process finishes with a certain result, but the image view or button is not set. + public var isNotCurrentTask: Bool { + if case .imageSettingError(reason: .notCurrentSourceTask(_, _, _)) = self { + return true + } + return false + } + + var isLowDataModeConstrained: Bool { + if #available(macOS 10.15, iOS 13.0, watchOS 6.0, tvOS 13.0, *), + case .responseError(reason: .URLSessionError(let sessionError)) = self, + let urlError = sessionError as? URLError, + urlError.networkUnavailableReason == .constrained + { + return true + } + return false + } + +} + +// MARK: - LocalizedError Conforming +extension KingfisherError: LocalizedError { + + /// A localized message describing what error occurred. + public var errorDescription: String? { + switch self { + case .requestError(let reason): return reason.errorDescription + case .responseError(let reason): return reason.errorDescription + case .cacheError(let reason): return reason.errorDescription + case .processorError(let reason): return reason.errorDescription + case .imageSettingError(let reason): return reason.errorDescription + } + } +} + + +// MARK: - CustomNSError Conforming +extension KingfisherError: CustomNSError { + + /// The error domain of `KingfisherError`. All errors from Kingfisher is under this domain. + public static let domain = "com.onevcat.Kingfisher.Error" + + /// The error code within the given domain. + public var errorCode: Int { + switch self { + case .requestError(let reason): return reason.errorCode + case .responseError(let reason): return reason.errorCode + case .cacheError(let reason): return reason.errorCode + case .processorError(let reason): return reason.errorCode + case .imageSettingError(let reason): return reason.errorCode + } + } +} + +extension KingfisherError.RequestErrorReason { + var errorDescription: String? { + switch self { + case .emptyRequest: + return "The request is empty or `nil`." + case .invalidURL(let request): + return "The request contains an invalid or empty URL. Request: \(request)." + case .taskCancelled(let task, let token): + return "The session task was cancelled. Task: \(task), cancel token: \(token)." + } + } + + var errorCode: Int { + switch self { + case .emptyRequest: return 1001 + case .invalidURL: return 1002 + case .taskCancelled: return 1003 + } + } +} + +extension KingfisherError.ResponseErrorReason { + var errorDescription: String? { + switch self { + case .invalidURLResponse(let response): + return "The URL response is invalid: \(response)" + case .invalidHTTPStatusCode(let response): + return "The HTTP status code in response is invalid. Code: \(response.statusCode), response: \(response)." + case .URLSessionError(let error): + return "A URL session error happened. The underlying error: \(error)" + case .dataModifyingFailed(let task): + return "The data modifying delegate returned `nil` for the downloaded data. Task: \(task)." + case .noURLResponse(let task): + return "No URL response received. Task: \(task)," + } + } + + var errorCode: Int { + switch self { + case .invalidURLResponse: return 2001 + case .invalidHTTPStatusCode: return 2002 + case .URLSessionError: return 2003 + case .dataModifyingFailed: return 2004 + case .noURLResponse: return 2005 + } + } +} + +extension KingfisherError.CacheErrorReason { + var errorDescription: String? { + switch self { + case .fileEnumeratorCreationFailed(let url): + return "Cannot create file enumerator for URL: \(url)." + case .invalidFileEnumeratorContent(let url): + return "Cannot get contents from the file enumerator at URL: \(url)." + case .invalidURLResource(let error, let key, let url): + return "Cannot get URL resource values or data for the given URL: \(url). " + + "Cache key: \(key). Underlying error: \(error)" + case .cannotLoadDataFromDisk(let url, let error): + return "Cannot load data from disk at URL: \(url). Underlying error: \(error)" + case .cannotCreateDirectory(let path, let error): + return "Cannot create directory at given path: Path: \(path). Underlying error: \(error)" + case .imageNotExisting(let key): + return "The image is not in cache, but you requires it should only be " + + "from cache by enabling the `.onlyFromCache` option. Key: \(key)." + case .cannotConvertToData(let object, let error): + return "Cannot convert the input object to a `Data` object when storing it to disk cache. " + + "Object: \(object). Underlying error: \(error)" + case .cannotSerializeImage(let image, let originalData, let serializer): + return "Cannot serialize an image due to the cache serializer returning `nil`. " + + "Image: \(String(describing:image)), original data: \(String(describing: originalData)), " + + "serializer: \(serializer)." + case .cannotCreateCacheFile(let fileURL, let key, let data, let error): + return "Cannot create cache file at url: \(fileURL), key: \(key), data length: \(data.count). " + + "Underlying foundation error: \(error)." + case .cannotSetCacheFileAttribute(let filePath, let attributes, let error): + return "Cannot set file attribute for the cache file at path: \(filePath), attributes: \(attributes)." + + "Underlying foundation error: \(error)." + case .diskStorageIsNotReady(let cacheURL): + return "The disk storage is not ready to use yet at URL: '\(cacheURL)'. " + + "This is usually caused by extremely lack of disk space. Ask users to free up some space and restart the app." + } + } + + var errorCode: Int { + switch self { + case .fileEnumeratorCreationFailed: return 3001 + case .invalidFileEnumeratorContent: return 3002 + case .invalidURLResource: return 3003 + case .cannotLoadDataFromDisk: return 3004 + case .cannotCreateDirectory: return 3005 + case .imageNotExisting: return 3006 + case .cannotConvertToData: return 3007 + case .cannotSerializeImage: return 3008 + case .cannotCreateCacheFile: return 3009 + case .cannotSetCacheFileAttribute: return 3010 + case .diskStorageIsNotReady: return 3011 + } + } +} + +extension KingfisherError.ProcessorErrorReason { + var errorDescription: String? { + switch self { + case .processingFailed(let processor, let item): + return "Processing image failed. Processor: \(processor). Processing item: \(item)." + } + } + + var errorCode: Int { + switch self { + case .processingFailed: return 4001 + } + } +} + +extension KingfisherError.ImageSettingErrorReason { + var errorDescription: String? { + switch self { + case .emptySource: + return "The input resource is empty." + case .notCurrentSourceTask(let result, let error, let resource): + if let result = result { + return "Retrieving resource succeeded, but this source is " + + "not the one currently expected. Result: \(result). Resource: \(resource)." + } else if let error = error { + return "Retrieving resource failed, and this resource is " + + "not the one currently expected. Error: \(error). Resource: \(resource)." + } else { + return nil + } + case .dataProviderError(let provider, let error): + return "Image data provider fails to provide data. Provider: \(provider), error: \(error)" + case .alternativeSourcesExhausted(let errors): + return "Image setting from alternaive sources failed: \(errors)" + } + } + + var errorCode: Int { + switch self { + case .emptySource: return 5001 + case .notCurrentSourceTask: return 5002 + case .dataProviderError: return 5003 + case .alternativeSourcesExhausted: return 5004 + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/General/KingfisherManager.swift b/Demo/Pods/Kingfisher/Sources/General/KingfisherManager.swift new file mode 100644 index 0000000..b0b9db1 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/KingfisherManager.swift @@ -0,0 +1,802 @@ +// +// KingfisherManager.swift +// Kingfisher +// +// Created by Wei Wang on 15/4/6. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + + +import Foundation + +/// The downloading progress block type. +/// The parameter value is the `receivedSize` of current response. +/// The second parameter is the total expected data length from response's "Content-Length" header. +/// If the expected length is not available, this block will not be called. +public typealias DownloadProgressBlock = ((_ receivedSize: Int64, _ totalSize: Int64) -> Void) + +/// Represents the result of a Kingfisher retrieving image task. +public struct RetrieveImageResult { + /// Gets the image object of this result. + public let image: KFCrossPlatformImage + + /// Gets the cache source of the image. It indicates from which layer of cache this image is retrieved. + /// If the image is just downloaded from network, `.none` will be returned. + public let cacheType: CacheType + + /// The `Source` which this result is related to. This indicated where the `image` of `self` is referring. + public let source: Source + + /// The original `Source` from which the retrieve task begins. It can be different from the `source` property. + /// When an alternative source loading happened, the `source` will be the replacing loading target, while the + /// `originalSource` will be kept as the initial `source` which issued the image loading process. + public let originalSource: Source + + /// Gets the data behind the result. + /// + /// If this result is from a network downloading (when `cacheType == .none`), calling this returns the downloaded + /// data. If the reuslt is from cache, it serializes the image with the given cache serializer in the loading option + /// and returns the result. + /// + /// - Note: + /// This can be a time-consuming action, so if you need to use the data for multiple times, it is suggested to hold + /// it and prevent keeping calling this too frequently. + public let data: () -> Data? +} + +/// A struct that stores some related information of an `KingfisherError`. It provides some context information for +/// a pure error so you can identify the error easier. +public struct PropagationError { + + /// The `Source` to which current `error` is bound. + public let source: Source + + /// The actual error happens in framework. + public let error: KingfisherError +} + + +/// The downloading task updated block type. The parameter `newTask` is the updated new task of image setting process. +/// It is a `nil` if the image loading does not require an image downloading process. If an image downloading is issued, +/// this value will contain the actual `DownloadTask` for you to keep and cancel it later if you need. +public typealias DownloadTaskUpdatedBlock = ((_ newTask: DownloadTask?) -> Void) + +/// Main manager class of Kingfisher. It connects Kingfisher downloader and cache, +/// to provide a set of convenience methods to use Kingfisher for tasks. +/// You can use this class to retrieve an image via a specified URL from web or cache. +public class KingfisherManager { + + /// Represents a shared manager used across Kingfisher. + /// Use this instance for getting or storing images with Kingfisher. + public static let shared = KingfisherManager() + + // Mark: Public Properties + /// The `ImageCache` used by this manager. It is `ImageCache.default` by default. + /// If a cache is specified in `KingfisherManager.defaultOptions`, the value in `defaultOptions` will be + /// used instead. + public var cache: ImageCache + + /// The `ImageDownloader` used by this manager. It is `ImageDownloader.default` by default. + /// If a downloader is specified in `KingfisherManager.defaultOptions`, the value in `defaultOptions` will be + /// used instead. + public var downloader: ImageDownloader + + /// Default options used by the manager. This option will be used in + /// Kingfisher manager related methods, as well as all view extension methods. + /// You can also passing other options for each image task by sending an `options` parameter + /// to Kingfisher's APIs. The per image options will overwrite the default ones, + /// if the option exists in both. + public var defaultOptions = KingfisherOptionsInfo.empty + + // Use `defaultOptions` to overwrite the `downloader` and `cache`. + private var currentDefaultOptions: KingfisherOptionsInfo { + return [.downloader(downloader), .targetCache(cache)] + defaultOptions + } + + private let processingQueue: CallbackQueue + + private convenience init() { + self.init(downloader: .default, cache: .default) + } + + /// Creates an image setting manager with specified downloader and cache. + /// + /// - Parameters: + /// - downloader: The image downloader used to download images. + /// - cache: The image cache which stores memory and disk images. + public init(downloader: ImageDownloader, cache: ImageCache) { + self.downloader = downloader + self.cache = cache + + let processQueueName = "com.onevcat.Kingfisher.KingfisherManager.processQueue.\(UUID().uuidString)" + processingQueue = .dispatch(DispatchQueue(label: processQueueName)) + } + + // MARK: - Getting Images + + /// Gets an image from a given resource. + /// - Parameters: + /// - resource: The `Resource` object defines data information like key or URL. + /// - options: Options to use when creating the image. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. `progressBlock` is always called in + /// main queue. + /// - downloadTaskUpdated: Called when a new image downloading task is created for current image retrieving. This + /// usually happens when an alternative source is used to replace the original (failed) + /// task. You can update your reference of `DownloadTask` if you want to manually `cancel` + /// the new task. + /// - completionHandler: Called when the image retrieved and set finished. This completion handler will be invoked + /// from the `options.callbackQueue`. If not specified, the main queue will be used. + /// - Returns: A task represents the image downloading. If there is a download task starts for `.network` resource, + /// the started `DownloadTask` is returned. Otherwise, `nil` is returned. + /// + /// - Note: + /// This method will first check whether the requested `resource` is already in cache or not. If cached, + /// it returns `nil` and invoke the `completionHandler` after the cached image retrieved. Otherwise, it + /// will download the `resource`, store it in cache, then call `completionHandler`. + @discardableResult + public func retrieveImage( + with resource: Resource, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + downloadTaskUpdated: DownloadTaskUpdatedBlock? = nil, + completionHandler: ((Result) -> Void)?) -> DownloadTask? + { + return retrieveImage( + with: resource.convertToSource(), + options: options, + progressBlock: progressBlock, + downloadTaskUpdated: downloadTaskUpdated, + completionHandler: completionHandler + ) + } + + /// Gets an image from a given resource. + /// + /// - Parameters: + /// - source: The `Source` object defines data information from network or a data provider. + /// - options: Options to use when creating the image. + /// - progressBlock: Called when the image downloading progress gets updated. If the response does not contain an + /// `expectedContentLength`, this block will not be called. `progressBlock` is always called in + /// main queue. + /// - downloadTaskUpdated: Called when a new image downloading task is created for current image retrieving. This + /// usually happens when an alternative source is used to replace the original (failed) + /// task. You can update your reference of `DownloadTask` if you want to manually `cancel` + /// the new task. + /// - completionHandler: Called when the image retrieved and set finished. This completion handler will be invoked + /// from the `options.callbackQueue`. If not specified, the main queue will be used. + /// - Returns: A task represents the image downloading. If there is a download task starts for `.network` resource, + /// the started `DownloadTask` is returned. Otherwise, `nil` is returned. + /// + /// - Note: + /// This method will first check whether the requested `source` is already in cache or not. If cached, + /// it returns `nil` and invoke the `completionHandler` after the cached image retrieved. Otherwise, it + /// will try to load the `source`, store it in cache, then call `completionHandler`. + /// + @discardableResult + public func retrieveImage( + with source: Source, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + downloadTaskUpdated: DownloadTaskUpdatedBlock? = nil, + completionHandler: ((Result) -> Void)?) -> DownloadTask? + { + let options = currentDefaultOptions + (options ?? .empty) + let info = KingfisherParsedOptionsInfo(options) + return retrieveImage( + with: source, + options: info, + progressBlock: progressBlock, + downloadTaskUpdated: downloadTaskUpdated, + completionHandler: completionHandler) + } + + func retrieveImage( + with source: Source, + options: KingfisherParsedOptionsInfo, + progressBlock: DownloadProgressBlock? = nil, + downloadTaskUpdated: DownloadTaskUpdatedBlock? = nil, + completionHandler: ((Result) -> Void)?) -> DownloadTask? + { + var info = options + if let block = progressBlock { + info.onDataReceived = (info.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + return retrieveImage( + with: source, + options: info, + downloadTaskUpdated: downloadTaskUpdated, + progressiveImageSetter: nil, + completionHandler: completionHandler) + } + + func retrieveImage( + with source: Source, + options: KingfisherParsedOptionsInfo, + downloadTaskUpdated: DownloadTaskUpdatedBlock? = nil, + progressiveImageSetter: ((KFCrossPlatformImage?) -> Void)? = nil, + referenceTaskIdentifierChecker: (() -> Bool)? = nil, + completionHandler: ((Result) -> Void)?) -> DownloadTask? + { + var options = options + if let provider = ImageProgressiveProvider(options, refresh: { image in + guard let setter = progressiveImageSetter else { + return + } + guard let strategy = options.progressiveJPEG?.onImageUpdated(image) else { + setter(image) + return + } + switch strategy { + case .default: setter(image) + case .keepCurrent: break + case .replace(let newImage): setter(newImage) + } + }) { + options.onDataReceived = (options.onDataReceived ?? []) + [provider] + } + if let checker = referenceTaskIdentifierChecker { + options.onDataReceived?.forEach { + $0.onShouldApply = checker + } + } + + let retrievingContext = RetrievingContext(options: options, originalSource: source) + var retryContext: RetryContext? + + func startNewRetrieveTask( + with source: Source, + downloadTaskUpdated: DownloadTaskUpdatedBlock? + ) { + let newTask = self.retrieveImage(with: source, context: retrievingContext) { result in + handler(currentSource: source, result: result) + } + downloadTaskUpdated?(newTask) + } + + func failCurrentSource(_ source: Source, with error: KingfisherError) { + // Skip alternative sources if the user cancelled it. + guard !error.isTaskCancelled else { + completionHandler?(.failure(error)) + return + } + // When low data mode constrained error, retry with the low data mode source instead of use alternative on fly. + guard !error.isLowDataModeConstrained else { + if let source = retrievingContext.options.lowDataModeSource { + retrievingContext.options.lowDataModeSource = nil + startNewRetrieveTask(with: source, downloadTaskUpdated: downloadTaskUpdated) + } else { + // This should not happen. + completionHandler?(.failure(error)) + } + return + } + if let nextSource = retrievingContext.popAlternativeSource() { + retrievingContext.appendError(error, to: source) + startNewRetrieveTask(with: nextSource, downloadTaskUpdated: downloadTaskUpdated) + } else { + // No other alternative source. Finish with error. + if retrievingContext.propagationErrors.isEmpty { + completionHandler?(.failure(error)) + } else { + retrievingContext.appendError(error, to: source) + let finalError = KingfisherError.imageSettingError( + reason: .alternativeSourcesExhausted(retrievingContext.propagationErrors) + ) + completionHandler?(.failure(finalError)) + } + } + } + + func handler(currentSource: Source, result: (Result)) -> Void { + switch result { + case .success: + completionHandler?(result) + case .failure(let error): + if let retryStrategy = options.retryStrategy { + let context = retryContext?.increaseRetryCount() ?? RetryContext(source: source, error: error) + retryContext = context + + retryStrategy.retry(context: context) { decision in + switch decision { + case .retry(let userInfo): + retryContext?.userInfo = userInfo + startNewRetrieveTask(with: source, downloadTaskUpdated: downloadTaskUpdated) + case .stop: + failCurrentSource(currentSource, with: error) + } + } + } else { + failCurrentSource(currentSource, with: error) + } + } + } + + return retrieveImage( + with: source, + context: retrievingContext) + { + result in + handler(currentSource: source, result: result) + } + + } + + private func retrieveImage( + with source: Source, + context: RetrievingContext, + completionHandler: ((Result) -> Void)?) -> DownloadTask? + { + let options = context.options + if options.forceRefresh { + return loadAndCacheImage( + source: source, + context: context, + completionHandler: completionHandler)?.value + + } else { + let loadedFromCache = retrieveImageFromCache( + source: source, + context: context, + completionHandler: completionHandler) + + if loadedFromCache { + return nil + } + + if options.onlyFromCache { + let error = KingfisherError.cacheError(reason: .imageNotExisting(key: source.cacheKey)) + completionHandler?(.failure(error)) + return nil + } + + return loadAndCacheImage( + source: source, + context: context, + completionHandler: completionHandler)?.value + } + } + + func provideImage( + provider: ImageDataProvider, + options: KingfisherParsedOptionsInfo, + completionHandler: ((Result) -> Void)?) + { + guard let completionHandler = completionHandler else { return } + provider.data { result in + switch result { + case .success(let data): + (options.processingQueue ?? self.processingQueue).execute { + let processor = options.processor + let processingItem = ImageProcessItem.data(data) + guard let image = processor.process(item: processingItem, options: options) else { + options.callbackQueue.execute { + let error = KingfisherError.processorError( + reason: .processingFailed(processor: processor, item: processingItem)) + completionHandler(.failure(error)) + } + return + } + + options.callbackQueue.execute { + let result = ImageLoadingResult(image: image, url: nil, originalData: data) + completionHandler(.success(result)) + } + } + case .failure(let error): + options.callbackQueue.execute { + let error = KingfisherError.imageSettingError( + reason: .dataProviderError(provider: provider, error: error)) + completionHandler(.failure(error)) + } + + } + } + } + + private func cacheImage( + source: Source, + options: KingfisherParsedOptionsInfo, + context: RetrievingContext, + result: Result, + completionHandler: ((Result) -> Void)? + ) + { + switch result { + case .success(let value): + let needToCacheOriginalImage = options.cacheOriginalImage && + options.processor != DefaultImageProcessor.default + let coordinator = CacheCallbackCoordinator( + shouldWaitForCache: options.waitForCache, shouldCacheOriginal: needToCacheOriginalImage) + let result = RetrieveImageResult( + image: options.imageModifier?.modify(value.image) ?? value.image, + cacheType: .none, + source: source, + originalSource: context.originalSource, + data: { value.originalData } + ) + // Add image to cache. + let targetCache = options.targetCache ?? self.cache + targetCache.store( + value.image, + original: value.originalData, + forKey: source.cacheKey, + options: options, + toDisk: !options.cacheMemoryOnly) + { + _ in + coordinator.apply(.cachingImage) { + completionHandler?(.success(result)) + } + } + + // Add original image to cache if necessary. + + if needToCacheOriginalImage { + let originalCache = options.originalCache ?? targetCache + originalCache.storeToDisk( + value.originalData, + forKey: source.cacheKey, + processorIdentifier: DefaultImageProcessor.default.identifier, + expiration: options.diskCacheExpiration) + { + _ in + coordinator.apply(.cachingOriginalImage) { + completionHandler?(.success(result)) + } + } + } + + coordinator.apply(.cacheInitiated) { + completionHandler?(.success(result)) + } + + case .failure(let error): + completionHandler?(.failure(error)) + } + } + + @discardableResult + func loadAndCacheImage( + source: Source, + context: RetrievingContext, + completionHandler: ((Result) -> Void)?) -> DownloadTask.WrappedTask? + { + let options = context.options + func _cacheImage(_ result: Result) { + cacheImage( + source: source, + options: options, + context: context, + result: result, + completionHandler: completionHandler + ) + } + + switch source { + case .network(let resource): + let downloader = options.downloader ?? self.downloader + let task = downloader.downloadImage( + with: resource.downloadURL, options: options, completionHandler: _cacheImage + ) + + + // The code below is neat, but it fails the Swift 5.2 compiler with a runtime crash when + // `BUILD_LIBRARY_FOR_DISTRIBUTION` is turned on. I believe it is a bug in the compiler. + // Let's fallback to a traditional style before it can be fixed in Swift. + // + // https://github.com/onevcat/Kingfisher/issues/1436 + // + // return task.map(DownloadTask.WrappedTask.download) + + if let task = task { + return .download(task) + } else { + return nil + } + + case .provider(let provider): + provideImage(provider: provider, options: options, completionHandler: _cacheImage) + return .dataProviding + } + } + + /// Retrieves image from memory or disk cache. + /// + /// - Parameters: + /// - source: The target source from which to get image. + /// - key: The key to use when caching the image. + /// - url: Image request URL. This is not used when retrieving image from cache. It is just used for + /// `RetrieveImageResult` callback compatibility. + /// - options: Options on how to get the image from image cache. + /// - completionHandler: Called when the image retrieving finishes, either with succeeded + /// `RetrieveImageResult` or an error. + /// - Returns: `true` if the requested image or the original image before being processed is existing in cache. + /// Otherwise, this method returns `false`. + /// + /// - Note: + /// The image retrieving could happen in either memory cache or disk cache. The `.processor` option in + /// `options` will be considered when searching in the cache. If no processed image is found, Kingfisher + /// will try to check whether an original version of that image is existing or not. If there is already an + /// original, Kingfisher retrieves it from cache and processes it. Then, the processed image will be store + /// back to cache for later use. + func retrieveImageFromCache( + source: Source, + context: RetrievingContext, + completionHandler: ((Result) -> Void)?) -> Bool + { + let options = context.options + // 1. Check whether the image was already in target cache. If so, just get it. + let targetCache = options.targetCache ?? cache + let key = source.cacheKey + let targetImageCached = targetCache.imageCachedType( + forKey: key, processorIdentifier: options.processor.identifier) + + let validCache = targetImageCached.cached && + (options.fromMemoryCacheOrRefresh == false || targetImageCached == .memory) + if validCache { + targetCache.retrieveImage(forKey: key, options: options) { result in + guard let completionHandler = completionHandler else { return } + + // TODO: Optimize it when we can use async across all the project. + func checkResultImageAndCallback(_ inputImage: KFCrossPlatformImage) { + var image = inputImage + if image.kf.imageFrameCount != nil && image.kf.imageFrameCount != 1, let data = image.kf.animatedImageData { + // Always recreate animated image representation since it is possible to be loaded in different options. + // https://github.com/onevcat/Kingfisher/issues/1923 + image = KingfisherWrapper.animatedImage(data: data, options: options.imageCreatingOptions) ?? .init() + } + if let modifier = options.imageModifier { + image = modifier.modify(image) + } + let value = result.map { + RetrieveImageResult( + image: image, + cacheType: $0.cacheType, + source: source, + originalSource: context.originalSource, + data: { options.cacheSerializer.data(with: image, original: nil) } + ) + } + completionHandler(value) + } + + result.match { cacheResult in + options.callbackQueue.execute { + guard let image = cacheResult.image else { + completionHandler(.failure(KingfisherError.cacheError(reason: .imageNotExisting(key: key)))) + return + } + + if options.cacheSerializer.originalDataUsed { + let processor = options.processor + (options.processingQueue ?? self.processingQueue).execute { + let item = ImageProcessItem.image(image) + guard let processedImage = processor.process(item: item, options: options) else { + let error = KingfisherError.processorError( + reason: .processingFailed(processor: processor, item: item)) + options.callbackQueue.execute { completionHandler(.failure(error)) } + return + } + options.callbackQueue.execute { + checkResultImageAndCallback(processedImage) + } + } + } else { + checkResultImageAndCallback(image) + } + } + } onFailure: { error in + options.callbackQueue.execute { + completionHandler(.failure(KingfisherError.cacheError(reason: .imageNotExisting(key: key)))) + } + } + } + return true + } + + // 2. Check whether the original image exists. If so, get it, process it, save to storage and return. + let originalCache = options.originalCache ?? targetCache + // No need to store the same file in the same cache again. + if originalCache === targetCache && options.processor == DefaultImageProcessor.default { + return false + } + + // Check whether the unprocessed image existing or not. + let originalImageCacheType = originalCache.imageCachedType( + forKey: key, processorIdentifier: DefaultImageProcessor.default.identifier) + let canAcceptDiskCache = !options.fromMemoryCacheOrRefresh + + let canUseOriginalImageCache = + (canAcceptDiskCache && originalImageCacheType.cached) || + (!canAcceptDiskCache && originalImageCacheType == .memory) + + if canUseOriginalImageCache { + // Now we are ready to get found the original image from cache. We need the unprocessed image, so remove + // any processor from options first. + var optionsWithoutProcessor = options + optionsWithoutProcessor.processor = DefaultImageProcessor.default + originalCache.retrieveImage(forKey: key, options: optionsWithoutProcessor) { result in + + result.match( + onSuccess: { cacheResult in + guard let image = cacheResult.image else { + assertionFailure("The image (under key: \(key) should be existing in the original cache.") + return + } + + let processor = options.processor + (options.processingQueue ?? self.processingQueue).execute { + let item = ImageProcessItem.image(image) + guard let processedImage = processor.process(item: item, options: options) else { + let error = KingfisherError.processorError( + reason: .processingFailed(processor: processor, item: item)) + options.callbackQueue.execute { completionHandler?(.failure(error)) } + return + } + + var cacheOptions = options + cacheOptions.callbackQueue = .untouch + + let coordinator = CacheCallbackCoordinator( + shouldWaitForCache: options.waitForCache, shouldCacheOriginal: false) + + let image = options.imageModifier?.modify(processedImage) ?? processedImage + let result = RetrieveImageResult( + image: image, + cacheType: .none, + source: source, + originalSource: context.originalSource, + data: { options.cacheSerializer.data(with: processedImage, original: nil) } + ) + + targetCache.store( + processedImage, + forKey: key, + options: cacheOptions, + toDisk: !options.cacheMemoryOnly) + { + _ in + coordinator.apply(.cachingImage) { + options.callbackQueue.execute { completionHandler?(.success(result)) } + } + } + + coordinator.apply(.cacheInitiated) { + options.callbackQueue.execute { completionHandler?(.success(result)) } + } + } + }, + onFailure: { _ in + // This should not happen actually, since we already confirmed `originalImageCached` is `true`. + // Just in case... + options.callbackQueue.execute { + completionHandler?( + .failure(KingfisherError.cacheError(reason: .imageNotExisting(key: key))) + ) + } + } + ) + } + return true + } + + return false + } +} + +class RetrievingContext { + + var options: KingfisherParsedOptionsInfo + + let originalSource: Source + var propagationErrors: [PropagationError] = [] + + init(options: KingfisherParsedOptionsInfo, originalSource: Source) { + self.originalSource = originalSource + self.options = options + } + + func popAlternativeSource() -> Source? { + guard var alternativeSources = options.alternativeSources, !alternativeSources.isEmpty else { + return nil + } + let nextSource = alternativeSources.removeFirst() + options.alternativeSources = alternativeSources + return nextSource + } + + @discardableResult + func appendError(_ error: KingfisherError, to source: Source) -> [PropagationError] { + let item = PropagationError(source: source, error: error) + propagationErrors.append(item) + return propagationErrors + } +} + +class CacheCallbackCoordinator { + + enum State { + case idle + case imageCached + case originalImageCached + case done + } + + enum Action { + case cacheInitiated + case cachingImage + case cachingOriginalImage + } + + private let shouldWaitForCache: Bool + private let shouldCacheOriginal: Bool + private let stateQueue: DispatchQueue + private var threadSafeState: State = .idle + + private (set) var state: State { + set { stateQueue.sync { threadSafeState = newValue } } + get { stateQueue.sync { threadSafeState } } + } + + init(shouldWaitForCache: Bool, shouldCacheOriginal: Bool) { + self.shouldWaitForCache = shouldWaitForCache + self.shouldCacheOriginal = shouldCacheOriginal + let stateQueueName = "com.onevcat.Kingfisher.CacheCallbackCoordinator.stateQueue.\(UUID().uuidString)" + self.stateQueue = DispatchQueue(label: stateQueueName) + } + + func apply(_ action: Action, trigger: () -> Void) { + switch (state, action) { + case (.done, _): + break + + // From .idle + case (.idle, .cacheInitiated): + if !shouldWaitForCache { + state = .done + trigger() + } + case (.idle, .cachingImage): + if shouldCacheOriginal { + state = .imageCached + } else { + state = .done + trigger() + } + case (.idle, .cachingOriginalImage): + state = .originalImageCached + + // From .imageCached + case (.imageCached, .cachingOriginalImage): + state = .done + trigger() + + // From .originalImageCached + case (.originalImageCached, .cachingImage): + state = .done + trigger() + + default: + assertionFailure("This case should not happen in CacheCallbackCoordinator: \(state) - \(action)") + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/General/KingfisherOptionsInfo.swift b/Demo/Pods/Kingfisher/Sources/General/KingfisherOptionsInfo.swift new file mode 100644 index 0000000..5f2aea6 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/General/KingfisherOptionsInfo.swift @@ -0,0 +1,400 @@ +// +// KingfisherOptionsInfo.swift +// Kingfisher +// +// Created by Wei Wang on 15/4/23. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if os(macOS) +import AppKit +#else +import UIKit +#endif + + +/// KingfisherOptionsInfo is a typealias for [KingfisherOptionsInfoItem]. +/// You can use the enum of option item with value to control some behaviors of Kingfisher. +public typealias KingfisherOptionsInfo = [KingfisherOptionsInfoItem] + +extension Array where Element == KingfisherOptionsInfoItem { + static let empty: KingfisherOptionsInfo = [] +} + +/// Represents the available option items could be used in `KingfisherOptionsInfo`. +public enum KingfisherOptionsInfoItem { + + /// Kingfisher will use the associated `ImageCache` object when handling related operations, + /// including trying to retrieve the cached images and store the downloaded image to it. + case targetCache(ImageCache) + + /// The `ImageCache` for storing and retrieving original images. If `originalCache` is + /// contained in the options, it will be preferred for storing and retrieving original images. + /// If there is no `.originalCache` in the options, `.targetCache` will be used to store original images. + /// + /// When using KingfisherManager to download and store an image, if `cacheOriginalImage` is + /// applied in the option, the original image will be stored to this `originalCache`. At the + /// same time, if a requested final image (with processor applied) cannot be found in `targetCache`, + /// Kingfisher will try to search the original image to check whether it is already there. If found, + /// it will be used and applied with the given processor. It is an optimization for not downloading + /// the same image for multiple times. + case originalCache(ImageCache) + + /// Kingfisher will use the associated `ImageDownloader` object to download the requested images. + case downloader(ImageDownloader) + + /// Member for animation transition when using `UIImageView`. Kingfisher will use the `ImageTransition` of + /// this enum to animate the image in if it is downloaded from web. The transition will not happen when the + /// image is retrieved from either memory or disk cache by default. If you need to do the transition even when + /// the image being retrieved from cache, set `.forceRefresh` as well. + case transition(ImageTransition) + + /// Associated `Float` value will be set as the priority of image download task. The value for it should be + /// between 0.0~1.0. If this option not set, the default value (`URLSessionTask.defaultPriority`) will be used. + case downloadPriority(Float) + + /// If set, Kingfisher will ignore the cache and try to start a download task for the image source. + case forceRefresh + + /// If set, Kingfisher will try to retrieve the image from memory cache first. If the image is not in memory + /// cache, then it will ignore the disk cache but download the image again from network. This is useful when + /// you want to display a changeable image behind the same url at the same app session, while avoiding download + /// it for multiple times. + case fromMemoryCacheOrRefresh + + /// If set, setting the image to an image view will happen with transition even when retrieved from cache. + /// See `.transition` option for more. + case forceTransition + + /// If set, Kingfisher will only cache the value in memory but not in disk. + case cacheMemoryOnly + + /// If set, Kingfisher will wait for caching operation to be completed before calling the completion block. + case waitForCache + + /// If set, Kingfisher will only try to retrieve the image from cache, but not from network. If the image is not in + /// cache, the image retrieving will fail with the `KingfisherError.cacheError` with `.imageNotExisting` as its + /// reason. + case onlyFromCache + + /// Decode the image in background thread before using. It will decode the downloaded image data and do a off-screen + /// rendering to extract pixel information in background. This can speed up display, but will cost more time to + /// prepare the image for using. + case backgroundDecode + + /// The associated value will be used as the target queue of dispatch callbacks when retrieving images from + /// cache. If not set, Kingfisher will use `.mainCurrentOrAsync` for callbacks. + /// + /// - Note: + /// This option does not affect the callbacks for UI related extension methods. You will always get the + /// callbacks called from main queue. + case callbackQueue(CallbackQueue) + + /// The associated value will be used as the scale factor when converting retrieved data to an image. + /// Specify the image scale, instead of your screen scale. You may need to set the correct scale when you dealing + /// with 2x or 3x retina images. Otherwise, Kingfisher will convert the data to image object at `scale` 1.0. + case scaleFactor(CGFloat) + + /// Whether all the animated image data should be preloaded. Default is `false`, which means only following frames + /// will be loaded on need. If `true`, all the animated image data will be loaded and decoded into memory. + /// + /// This option is mainly used for back compatibility internally. You should not set it directly. Instead, + /// you should choose the image view class to control the GIF data loading. There are two classes in Kingfisher + /// support to display a GIF image. `AnimatedImageView` does not preload all data, it takes much less memory, but + /// uses more CPU when display. While a normal image view (`UIImageView` or `NSImageView`) loads all data at once, + /// which uses more memory but only decode image frames once. + case preloadAllAnimationData + + /// The `ImageDownloadRequestModifier` contained will be used to change the request before it being sent. + /// This is the last chance you can modify the image download request. You can modify the request for some + /// customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url mapping. + /// The original request will be sent without any modification by default. + case requestModifier(AsyncImageDownloadRequestModifier) + + /// The `ImageDownloadRedirectHandler` contained will be used to change the request before redirection. + /// This is the possibility you can modify the image download request during redirect. You can modify the request for + /// some customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url + /// mapping. + /// The original redirection request will be sent without any modification by default. + case redirectHandler(ImageDownloadRedirectHandler) + + /// Processor for processing when the downloading finishes, a processor will convert the downloaded data to an image + /// and/or apply some filter on it. If a cache is connected to the downloader (it happens when you are using + /// KingfisherManager or any of the view extension methods), the converted image will also be sent to cache as well. + /// If not set, the `DefaultImageProcessor.default` will be used. + case processor(ImageProcessor) + + /// Provides a `CacheSerializer` to convert some data to an image object for + /// retrieving from disk cache or vice versa for storing to disk cache. + /// If not set, the `DefaultCacheSerializer.default` will be used. + case cacheSerializer(CacheSerializer) + + /// An `ImageModifier` is for modifying an image as needed right before it is used. If the image was fetched + /// directly from the downloader, the modifier will run directly after the `ImageProcessor`. If the image is being + /// fetched from a cache, the modifier will run after the `CacheSerializer`. + /// + /// Use `ImageModifier` when you need to set properties that do not persist when caching the image on a concrete + /// type of `Image`, such as the `renderingMode` or the `alignmentInsets` of `UIImage`. + case imageModifier(ImageModifier) + + /// Keep the existing image of image view while setting another image to it. + /// By setting this option, the placeholder image parameter of image view extension method + /// will be ignored and the current image will be kept while loading or downloading the new image. + case keepCurrentImageWhileLoading + + /// If set, Kingfisher will only load the first frame from an animated image file as a single image. + /// Loading an animated images may take too much memory. It will be useful when you want to display a + /// static preview of the first frame from an animated image. + /// + /// This option will be ignored if the target image is not animated image data. + case onlyLoadFirstFrame + + /// If set and an `ImageProcessor` is used, Kingfisher will try to cache both the final result and original + /// image. Kingfisher will have a chance to use the original image when another processor is applied to the same + /// resource, instead of downloading it again. You can use `.originalCache` to specify a cache or the original + /// images if necessary. + /// + /// The original image will be only cached to disk storage. + case cacheOriginalImage + + /// If set and an image retrieving error occurred Kingfisher will set provided image (or empty) + /// in place of requested one. It's useful when you don't want to show placeholder + /// during loading time but wants to use some default image when requests will be failed. + case onFailureImage(KFCrossPlatformImage?) + + /// If set and used in `ImagePrefetcher`, the prefetching operation will load the images into memory storage + /// aggressively. By default this is not contained in the options, that means if the requested image is already + /// in disk cache, Kingfisher will not try to load it to memory. + case alsoPrefetchToMemory + + /// If set, the disk storage loading will happen in the same calling queue. By default, disk storage file loading + /// happens in its own queue with an asynchronous dispatch behavior. Although it provides better non-blocking disk + /// loading performance, it also causes a flickering when you reload an image from disk, if the image view already + /// has an image set. + /// + /// Set this options will stop that flickering by keeping all loading in the same queue (typically the UI queue + /// if you are using Kingfisher's extension methods to set an image), with a tradeoff of loading performance. + case loadDiskFileSynchronously + + /// Options to control the writing of data to disk storage + /// If set, options will be passed the store operation for a new files. + case diskStoreWriteOptions(Data.WritingOptions) + + /// The expiration setting for memory cache. By default, the underlying `MemoryStorage.Backend` uses the + /// expiration in its config for all items. If set, the `MemoryStorage.Backend` will use this associated + /// value to overwrite the config setting for this caching item. + case memoryCacheExpiration(StorageExpiration) + + /// The expiration extending setting for memory cache. The item expiration time will be incremented by this + /// value after access. + /// By default, the underlying `MemoryStorage.Backend` uses the initial cache expiration as extending + /// value: .cacheTime. + /// + /// To disable extending option at all add memoryCacheAccessExtendingExpiration(.none) to options. + case memoryCacheAccessExtendingExpiration(ExpirationExtending) + + /// The expiration setting for disk cache. By default, the underlying `DiskStorage.Backend` uses the + /// expiration in its config for all items. If set, the `DiskStorage.Backend` will use this associated + /// value to overwrite the config setting for this caching item. + case diskCacheExpiration(StorageExpiration) + + /// The expiration extending setting for disk cache. The item expiration time will be incremented by this value after access. + /// By default, the underlying `DiskStorage.Backend` uses the initial cache expiration as extending value: .cacheTime. + /// To disable extending option at all add diskCacheAccessExtendingExpiration(.none) to options. + case diskCacheAccessExtendingExpiration(ExpirationExtending) + + /// Decides on which queue the image processing should happen. By default, Kingfisher uses a pre-defined serial + /// queue to process images. Use this option to change this behavior. For example, specify a `.mainCurrentOrAsync` + /// to let the image be processed in main queue to prevent a possible flickering (but with a possibility of + /// blocking the UI, especially if the processor needs a lot of time to run). + case processingQueue(CallbackQueue) + + /// Enable progressive image loading, Kingfisher will use the associated `ImageProgressive` value to process the + /// progressive JPEG data and display it in a progressive way. + case progressiveJPEG(ImageProgressive) + + /// The alternative sources will be used when the original input `Source` fails. The `Source`s in the associated + /// array will be used to start a new image loading task if the previous task fails due to an error. The image + /// source loading process will stop as soon as a source is loaded successfully. If all `[Source]`s are used but + /// the loading is still failing, an `imageSettingError` with `alternativeSourcesExhausted` as its reason will be + /// thrown out. + /// + /// This option is useful if you want to implement a fallback solution for setting image. + /// + /// User cancellation will not trigger the alternative source loading. + case alternativeSources([Source]) + + /// Provide a retry strategy which will be used when something gets wrong during the image retrieving process from + /// `KingfisherManager`. You can define a strategy by create a type conforming to the `RetryStrategy` protocol. + /// + /// - Note: + /// + /// All extension methods of Kingfisher (`kf` extensions on `UIImageView` or `UIButton`) retrieve images through + /// `KingfisherManager`, so the retry strategy also applies when using them. However, this option does not apply + /// when pass to an `ImageDownloader` or `ImageCache`. + /// + case retryStrategy(RetryStrategy) + + /// The `Source` should be loaded when user enables Low Data Mode and the original source fails with an + /// `NSURLErrorNetworkUnavailableReason.constrained` error. When this option is set, the + /// `allowsConstrainedNetworkAccess` property of the request for the original source will be set to `false` and the + /// `Source` in associated value will be used to retrieve the image for low data mode. Usually, you can provide a + /// low-resolution version of your image or a local image provider to display a placeholder. + /// + /// If not set or the `source` is `nil`, the device Low Data Mode will be ignored and the original source will + /// be loaded following the system default behavior, in a normal way. + case lowDataMode(Source?) +} + +// Improve performance by parsing the input `KingfisherOptionsInfo` (self) first. +// So we can prevent the iterating over the options array again and again. +/// The parsed options info used across Kingfisher methods. Each property in this type corresponds a case member +/// in `KingfisherOptionsInfoItem`. When a `KingfisherOptionsInfo` sent to Kingfisher related methods, it will be +/// parsed and converted to a `KingfisherParsedOptionsInfo` first, and pass through the internal methods. +public struct KingfisherParsedOptionsInfo { + + public var targetCache: ImageCache? = nil + public var originalCache: ImageCache? = nil + public var downloader: ImageDownloader? = nil + public var transition: ImageTransition = .none + public var downloadPriority: Float = URLSessionTask.defaultPriority + public var forceRefresh = false + public var fromMemoryCacheOrRefresh = false + public var forceTransition = false + public var cacheMemoryOnly = false + public var waitForCache = false + public var onlyFromCache = false + public var backgroundDecode = false + public var preloadAllAnimationData = false + public var callbackQueue: CallbackQueue = .mainCurrentOrAsync + public var scaleFactor: CGFloat = 1.0 + public var requestModifier: AsyncImageDownloadRequestModifier? = nil + public var redirectHandler: ImageDownloadRedirectHandler? = nil + public var processor: ImageProcessor = DefaultImageProcessor.default + public var imageModifier: ImageModifier? = nil + public var cacheSerializer: CacheSerializer = DefaultCacheSerializer.default + public var keepCurrentImageWhileLoading = false + public var onlyLoadFirstFrame = false + public var cacheOriginalImage = false + public var onFailureImage: Optional = .none + public var alsoPrefetchToMemory = false + public var loadDiskFileSynchronously = false + public var diskStoreWriteOptions: Data.WritingOptions = [] + public var memoryCacheExpiration: StorageExpiration? = nil + public var memoryCacheAccessExtendingExpiration: ExpirationExtending = .cacheTime + public var diskCacheExpiration: StorageExpiration? = nil + public var diskCacheAccessExtendingExpiration: ExpirationExtending = .cacheTime + public var processingQueue: CallbackQueue? = nil + public var progressiveJPEG: ImageProgressive? = nil + public var alternativeSources: [Source]? = nil + public var retryStrategy: RetryStrategy? = nil + public var lowDataModeSource: Source? = nil + + var onDataReceived: [DataReceivingSideEffect]? = nil + + public init(_ info: KingfisherOptionsInfo?) { + guard let info = info else { return } + for option in info { + switch option { + case .targetCache(let value): targetCache = value + case .originalCache(let value): originalCache = value + case .downloader(let value): downloader = value + case .transition(let value): transition = value + case .downloadPriority(let value): downloadPriority = value + case .forceRefresh: forceRefresh = true + case .fromMemoryCacheOrRefresh: fromMemoryCacheOrRefresh = true + case .forceTransition: forceTransition = true + case .cacheMemoryOnly: cacheMemoryOnly = true + case .waitForCache: waitForCache = true + case .onlyFromCache: onlyFromCache = true + case .backgroundDecode: backgroundDecode = true + case .preloadAllAnimationData: preloadAllAnimationData = true + case .callbackQueue(let value): callbackQueue = value + case .scaleFactor(let value): scaleFactor = value + case .requestModifier(let value): requestModifier = value + case .redirectHandler(let value): redirectHandler = value + case .processor(let value): processor = value + case .imageModifier(let value): imageModifier = value + case .cacheSerializer(let value): cacheSerializer = value + case .keepCurrentImageWhileLoading: keepCurrentImageWhileLoading = true + case .onlyLoadFirstFrame: onlyLoadFirstFrame = true + case .cacheOriginalImage: cacheOriginalImage = true + case .onFailureImage(let value): onFailureImage = .some(value) + case .alsoPrefetchToMemory: alsoPrefetchToMemory = true + case .loadDiskFileSynchronously: loadDiskFileSynchronously = true + case .diskStoreWriteOptions(let options): diskStoreWriteOptions = options + case .memoryCacheExpiration(let expiration): memoryCacheExpiration = expiration + case .memoryCacheAccessExtendingExpiration(let expirationExtending): memoryCacheAccessExtendingExpiration = expirationExtending + case .diskCacheExpiration(let expiration): diskCacheExpiration = expiration + case .diskCacheAccessExtendingExpiration(let expirationExtending): diskCacheAccessExtendingExpiration = expirationExtending + case .processingQueue(let queue): processingQueue = queue + case .progressiveJPEG(let value): progressiveJPEG = value + case .alternativeSources(let sources): alternativeSources = sources + case .retryStrategy(let strategy): retryStrategy = strategy + case .lowDataMode(let source): lowDataModeSource = source + } + } + + if originalCache == nil { + originalCache = targetCache + } + } +} + +extension KingfisherParsedOptionsInfo { + var imageCreatingOptions: ImageCreatingOptions { + return ImageCreatingOptions( + scale: scaleFactor, + duration: 0.0, + preloadAll: preloadAllAnimationData, + onlyFirstFrame: onlyLoadFirstFrame) + } +} + +protocol DataReceivingSideEffect: AnyObject { + var onShouldApply: () -> Bool { get set } + func onDataReceived(_ session: URLSession, task: SessionDataTask, data: Data) +} + +class ImageLoadingProgressSideEffect: DataReceivingSideEffect { + + var onShouldApply: () -> Bool = { return true } + + let block: DownloadProgressBlock + + init(_ block: @escaping DownloadProgressBlock) { + self.block = block + } + + func onDataReceived(_ session: URLSession, task: SessionDataTask, data: Data) { + guard self.onShouldApply() else { return } + guard let expectedContentLength = task.task.response?.expectedContentLength, + expectedContentLength != -1 else + { + return + } + + let dataLength = Int64(task.mutableData.count) + DispatchQueue.main.async { + self.block(dataLength, expectedContentLength) + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Image/Filter.swift b/Demo/Pods/Kingfisher/Sources/Image/Filter.swift new file mode 100644 index 0000000..6e4b386 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/Filter.swift @@ -0,0 +1,146 @@ +// +// Filter.swift +// Kingfisher +// +// Created by Wei Wang on 2016/08/31. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if !os(watchOS) + +import CoreImage + +// Reuse the same CI Context for all CI drawing. +private let ciContext = CIContext(options: nil) + +/// Represents the type of transformer method, which will be used in to provide a `Filter`. +public typealias Transformer = (CIImage) -> CIImage? + +/// Represents a processor based on a `CIImage` `Filter`. +/// It requires a filter to create an `ImageProcessor`. +public protocol CIImageProcessor: ImageProcessor { + var filter: Filter { get } +} + +extension CIImageProcessor { + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.apply(filter) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// A wrapper struct for a `Transformer` of CIImage filters. A `Filter` +/// value could be used to create a `CIImage` processor. +public struct Filter { + + let transform: Transformer + + public init(transform: @escaping Transformer) { + self.transform = transform + } + + /// Tint filter which will apply a tint color to images. + public static var tint: (KFCrossPlatformColor) -> Filter = { + color in + Filter { + input in + + let colorFilter = CIFilter(name: "CIConstantColorGenerator")! + colorFilter.setValue(CIColor(color: color), forKey: kCIInputColorKey) + + let filter = CIFilter(name: "CISourceOverCompositing")! + + let colorImage = colorFilter.outputImage + filter.setValue(colorImage, forKey: kCIInputImageKey) + filter.setValue(input, forKey: kCIInputBackgroundImageKey) + + return filter.outputImage?.cropped(to: input.extent) + } + } + + /// Represents color control elements. It is a tuple of + /// `(brightness, contrast, saturation, inputEV)` + public typealias ColorElement = (CGFloat, CGFloat, CGFloat, CGFloat) + + /// Color control filter which will apply color control change to images. + public static var colorControl: (ColorElement) -> Filter = { arg -> Filter in + let (brightness, contrast, saturation, inputEV) = arg + return Filter { input in + let paramsColor = [kCIInputBrightnessKey: brightness, + kCIInputContrastKey: contrast, + kCIInputSaturationKey: saturation] + let blackAndWhite = input.applyingFilter("CIColorControls", parameters: paramsColor) + let paramsExposure = [kCIInputEVKey: inputEV] + return blackAndWhite.applyingFilter("CIExposureAdjust", parameters: paramsExposure) + } + } +} + +extension KingfisherWrapper where Base: KFCrossPlatformImage { + + /// Applies a `Filter` containing `CIImage` transformer to `self`. + /// + /// - Parameter filter: The filter used to transform `self`. + /// - Returns: A transformed image by input `Filter`. + /// + /// - Note: + /// Only CG-based images are supported. If any error happens + /// during transforming, `self` will be returned. + public func apply(_ filter: Filter) -> KFCrossPlatformImage { + + guard let cgImage = cgImage else { + assertionFailure("[Kingfisher] Tint image only works for CG-based image.") + return base + } + + let inputImage = CIImage(cgImage: cgImage) + guard let outputImage = filter.transform(inputImage) else { + return base + } + + guard let result = ciContext.createCGImage(outputImage, from: outputImage.extent) else { + assertionFailure("[Kingfisher] Can not make an tint image within context.") + return base + } + + #if os(macOS) + return fixedForRetinaPixel(cgImage: result, to: size) + #else + return KFCrossPlatformImage(cgImage: result, scale: base.scale, orientation: base.imageOrientation) + #endif + } + +} + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Image/GIFAnimatedImage.swift b/Demo/Pods/Kingfisher/Sources/Image/GIFAnimatedImage.swift new file mode 100644 index 0000000..8b2480f --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/GIFAnimatedImage.swift @@ -0,0 +1,121 @@ +// +// AnimatedImage.swift +// Kingfisher +// +// Created by onevcat on 2018/09/26. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import ImageIO + +/// Represents a set of image creating options used in Kingfisher. +public struct ImageCreatingOptions { + + /// The target scale of image needs to be created. + public let scale: CGFloat + + /// The expected animation duration if an animated image being created. + public let duration: TimeInterval + + /// For an animated image, whether or not all frames should be loaded before displaying. + public let preloadAll: Bool + + /// For an animated image, whether or not only the first image should be + /// loaded as a static image. It is useful for preview purpose of an animated image. + public let onlyFirstFrame: Bool + + /// Creates an `ImageCreatingOptions` object. + /// + /// - Parameters: + /// - scale: The target scale of image needs to be created. Default is `1.0`. + /// - duration: The expected animation duration if an animated image being created. + /// A value less or equal to `0.0` means the animated image duration will + /// be determined by the frame data. Default is `0.0`. + /// - preloadAll: For an animated image, whether or not all frames should be loaded before displaying. + /// Default is `false`. + /// - onlyFirstFrame: For an animated image, whether or not only the first image should be + /// loaded as a static image. It is useful for preview purpose of an animated image. + /// Default is `false`. + public init( + scale: CGFloat = 1.0, + duration: TimeInterval = 0.0, + preloadAll: Bool = false, + onlyFirstFrame: Bool = false) + { + self.scale = scale + self.duration = duration + self.preloadAll = preloadAll + self.onlyFirstFrame = onlyFirstFrame + } +} + +/// Represents the decoding for a GIF image. This class extracts frames from an `imageSource`, then +/// hold the images for later use. +public class GIFAnimatedImage { + let images: [KFCrossPlatformImage] + let duration: TimeInterval + + init?(from imageSource: CGImageSource, for info: [String: Any], options: ImageCreatingOptions) { + let frameCount = CGImageSourceGetCount(imageSource) + var images = [KFCrossPlatformImage]() + var gifDuration = 0.0 + + for i in 0 ..< frameCount { + guard let imageRef = CGImageSourceCreateImageAtIndex(imageSource, i, info as CFDictionary) else { + return nil + } + + if frameCount == 1 { + gifDuration = .infinity + } else { + // Get current animated GIF frame duration + gifDuration += GIFAnimatedImage.getFrameDuration(from: imageSource, at: i) + } + images.append(KingfisherWrapper.image(cgImage: imageRef, scale: options.scale, refImage: nil)) + if options.onlyFirstFrame { break } + } + self.images = images + self.duration = gifDuration + } + + /// Calculates frame duration for a gif frame out of the kCGImagePropertyGIFDictionary dictionary. + public static func getFrameDuration(from gifInfo: [String: Any]?) -> TimeInterval { + let defaultFrameDuration = 0.1 + guard let gifInfo = gifInfo else { return defaultFrameDuration } + + let unclampedDelayTime = gifInfo[kCGImagePropertyGIFUnclampedDelayTime as String] as? NSNumber + let delayTime = gifInfo[kCGImagePropertyGIFDelayTime as String] as? NSNumber + let duration = unclampedDelayTime ?? delayTime + + guard let frameDuration = duration else { return defaultFrameDuration } + return frameDuration.doubleValue > 0.011 ? frameDuration.doubleValue : defaultFrameDuration + } + + /// Calculates frame duration at a specific index for a gif from an `imageSource`. + public static func getFrameDuration(from imageSource: CGImageSource, at index: Int) -> TimeInterval { + guard let properties = CGImageSourceCopyPropertiesAtIndex(imageSource, index, nil) + as? [String: Any] else { return 0.0 } + + let gifInfo = properties[kCGImagePropertyGIFDictionary as String] as? [String: Any] + return getFrameDuration(from: gifInfo) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Image/GraphicsContext.swift b/Demo/Pods/Kingfisher/Sources/Image/GraphicsContext.swift new file mode 100644 index 0000000..6d8443c --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/GraphicsContext.swift @@ -0,0 +1,88 @@ +// +// GraphicsContext.swift +// Kingfisher +// +// Created by taras on 19/04/2021. +// +// Copyright (c) 2021 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) +import AppKit +#endif +#if canImport(UIKit) +import UIKit +#endif + +enum GraphicsContext { + static func begin(size: CGSize, scale: CGFloat) { + #if os(macOS) + NSGraphicsContext.saveGraphicsState() + #else + UIGraphicsBeginImageContextWithOptions(size, false, scale) + #endif + } + + static func current(size: CGSize, scale: CGFloat, inverting: Bool, cgImage: CGImage?) -> CGContext? { + #if os(macOS) + guard let rep = NSBitmapImageRep( + bitmapDataPlanes: nil, + pixelsWide: Int(size.width), + pixelsHigh: Int(size.height), + bitsPerSample: cgImage?.bitsPerComponent ?? 8, + samplesPerPixel: 4, + hasAlpha: true, + isPlanar: false, + colorSpaceName: .calibratedRGB, + bytesPerRow: 0, + bitsPerPixel: 0) else + { + assertionFailure("[Kingfisher] Image representation cannot be created.") + return nil + } + rep.size = size + guard let context = NSGraphicsContext(bitmapImageRep: rep) else { + assertionFailure("[Kingfisher] Image context cannot be created.") + return nil + } + + NSGraphicsContext.current = context + return context.cgContext + #else + guard let context = UIGraphicsGetCurrentContext() else { + return nil + } + if inverting { // If drawing a CGImage, we need to make context flipped. + context.scaleBy(x: 1.0, y: -1.0) + context.translateBy(x: 0, y: -size.height) + } + return context + #endif + } + + static func end() { + #if os(macOS) + NSGraphicsContext.restoreGraphicsState() + #else + UIGraphicsEndImageContext() + #endif + } +} + diff --git a/Demo/Pods/Kingfisher/Sources/Image/Image.swift b/Demo/Pods/Kingfisher/Sources/Image/Image.swift new file mode 100644 index 0000000..5e6c9a3 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/Image.swift @@ -0,0 +1,377 @@ +// +// Image.swift +// Kingfisher +// +// Created by Wei Wang on 16/1/6. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + + +#if os(macOS) +import AppKit +private var imagesKey: Void? +private var durationKey: Void? +#else +import UIKit +import MobileCoreServices +private var imageSourceKey: Void? +#endif + +#if !os(watchOS) +import CoreImage +#endif + +import CoreGraphics +import ImageIO + +private var animatedImageDataKey: Void? +private var imageFrameCountKey: Void? + +// MARK: - Image Properties +extension KingfisherWrapper where Base: KFCrossPlatformImage { + private(set) var animatedImageData: Data? { + get { return getAssociatedObject(base, &animatedImageDataKey) } + set { setRetainedAssociatedObject(base, &animatedImageDataKey, newValue) } + } + + public var imageFrameCount: Int? { + get { return getAssociatedObject(base, &imageFrameCountKey) } + set { setRetainedAssociatedObject(base, &imageFrameCountKey, newValue) } + } + + #if os(macOS) + var cgImage: CGImage? { + return base.cgImage(forProposedRect: nil, context: nil, hints: nil) + } + + var scale: CGFloat { + return 1.0 + } + + private(set) var images: [KFCrossPlatformImage]? { + get { return getAssociatedObject(base, &imagesKey) } + set { setRetainedAssociatedObject(base, &imagesKey, newValue) } + } + + private(set) var duration: TimeInterval { + get { return getAssociatedObject(base, &durationKey) ?? 0.0 } + set { setRetainedAssociatedObject(base, &durationKey, newValue) } + } + + var size: CGSize { + return base.representations.reduce(.zero) { size, rep in + let width = max(size.width, CGFloat(rep.pixelsWide)) + let height = max(size.height, CGFloat(rep.pixelsHigh)) + return CGSize(width: width, height: height) + } + } + #else + var cgImage: CGImage? { return base.cgImage } + var scale: CGFloat { return base.scale } + var images: [KFCrossPlatformImage]? { return base.images } + var duration: TimeInterval { return base.duration } + var size: CGSize { return base.size } + + /// The image source reference of current image. + public private(set) var imageSource: CGImageSource? { + get { return getAssociatedObject(base, &imageSourceKey) } + set { setRetainedAssociatedObject(base, &imageSourceKey, newValue) } + } + #endif + + // Bitmap memory cost with bytes. + var cost: Int { + let pixel = Int(size.width * size.height * scale * scale) + guard let cgImage = cgImage else { + return pixel * 4 + } + let bytesPerPixel = cgImage.bitsPerPixel / 8 + guard let imageCount = images?.count else { + return pixel * bytesPerPixel + } + return pixel * bytesPerPixel * imageCount + } +} + +// MARK: - Image Conversion +extension KingfisherWrapper where Base: KFCrossPlatformImage { + #if os(macOS) + static func image(cgImage: CGImage, scale: CGFloat, refImage: KFCrossPlatformImage?) -> KFCrossPlatformImage { + return KFCrossPlatformImage(cgImage: cgImage, size: .zero) + } + + /// Normalize the image. This getter does nothing on macOS but return the image itself. + public var normalized: KFCrossPlatformImage { return base } + + #else + /// Creating an image from a give `CGImage` at scale and orientation for refImage. The method signature is for + /// compatibility of macOS version. + static func image(cgImage: CGImage, scale: CGFloat, refImage: KFCrossPlatformImage?) -> KFCrossPlatformImage { + return KFCrossPlatformImage(cgImage: cgImage, scale: scale, orientation: refImage?.imageOrientation ?? .up) + } + + /// Returns normalized image for current `base` image. + /// This method will try to redraw an image with orientation and scale considered. + public var normalized: KFCrossPlatformImage { + // prevent animated image (GIF) lose it's images + guard images == nil else { return base.copy() as! KFCrossPlatformImage } + // No need to do anything if already up + guard base.imageOrientation != .up else { return base.copy() as! KFCrossPlatformImage } + + return draw(to: size, inverting: true, refImage: KFCrossPlatformImage()) { + fixOrientation(in: $0) + return true + } + } + + func fixOrientation(in context: CGContext) { + + var transform = CGAffineTransform.identity + + let orientation = base.imageOrientation + + switch orientation { + case .down, .downMirrored: + transform = transform.translatedBy(x: size.width, y: size.height) + transform = transform.rotated(by: .pi) + case .left, .leftMirrored: + transform = transform.translatedBy(x: size.width, y: 0) + transform = transform.rotated(by: .pi / 2.0) + case .right, .rightMirrored: + transform = transform.translatedBy(x: 0, y: size.height) + transform = transform.rotated(by: .pi / -2.0) + case .up, .upMirrored: + break + #if compiler(>=5) + @unknown default: + break + #endif + } + + //Flip image one more time if needed to, this is to prevent flipped image + switch orientation { + case .upMirrored, .downMirrored: + transform = transform.translatedBy(x: size.width, y: 0) + transform = transform.scaledBy(x: -1, y: 1) + case .leftMirrored, .rightMirrored: + transform = transform.translatedBy(x: size.height, y: 0) + transform = transform.scaledBy(x: -1, y: 1) + case .up, .down, .left, .right: + break + #if compiler(>=5) + @unknown default: + break + #endif + } + + context.concatenate(transform) + switch orientation { + case .left, .leftMirrored, .right, .rightMirrored: + context.draw(cgImage!, in: CGRect(x: 0, y: 0, width: size.height, height: size.width)) + default: + context.draw(cgImage!, in: CGRect(x: 0, y: 0, width: size.width, height: size.height)) + } + } + #endif +} + +// MARK: - Image Representation +extension KingfisherWrapper where Base: KFCrossPlatformImage { + /// Returns PNG representation of `base` image. + /// + /// - Returns: PNG data of image. + public func pngRepresentation() -> Data? { + #if os(macOS) + guard let cgImage = cgImage else { + return nil + } + let rep = NSBitmapImageRep(cgImage: cgImage) + return rep.representation(using: .png, properties: [:]) + #else + return base.pngData() + #endif + } + + /// Returns JPEG representation of `base` image. + /// + /// - Parameter compressionQuality: The compression quality when converting image to JPEG data. + /// - Returns: JPEG data of image. + public func jpegRepresentation(compressionQuality: CGFloat) -> Data? { + #if os(macOS) + guard let cgImage = cgImage else { + return nil + } + let rep = NSBitmapImageRep(cgImage: cgImage) + return rep.representation(using:.jpeg, properties: [.compressionFactor: compressionQuality]) + #else + return base.jpegData(compressionQuality: compressionQuality) + #endif + } + + /// Returns GIF representation of `base` image. + /// + /// - Returns: Original GIF data of image. + public func gifRepresentation() -> Data? { + return animatedImageData + } + + /// Returns a data representation for `base` image, with the `format` as the format indicator. + /// - Parameters: + /// - format: The format in which the output data should be. If `unknown`, the `base` image will be + /// converted in the PNG representation. + /// - compressionQuality: The compression quality when converting image to a lossy format data. + /// + /// - Returns: The output data representing. + public func data(format: ImageFormat, compressionQuality: CGFloat = 1.0) -> Data? { + return autoreleasepool { () -> Data? in + let data: Data? + switch format { + case .PNG: data = pngRepresentation() + case .JPEG: data = jpegRepresentation(compressionQuality: compressionQuality) + case .GIF: data = gifRepresentation() + case .unknown: data = normalized.kf.pngRepresentation() + } + + return data + } + } +} + +// MARK: - Creating Images +extension KingfisherWrapper where Base: KFCrossPlatformImage { + + /// Creates an animated image from a given data and options. Currently only GIF data is supported. + /// + /// - Parameters: + /// - data: The animated image data. + /// - options: Options to use when creating the animated image. + /// - Returns: An `Image` object represents the animated image. It is in form of an array of image frames with a + /// certain duration. `nil` if anything wrong when creating animated image. + public static func animatedImage(data: Data, options: ImageCreatingOptions) -> KFCrossPlatformImage? { + let info: [String: Any] = [ + kCGImageSourceShouldCache as String: true, + kCGImageSourceTypeIdentifierHint as String: kUTTypeGIF + ] + + guard let imageSource = CGImageSourceCreateWithData(data as CFData, info as CFDictionary) else { + return nil + } + + #if os(macOS) + guard let animatedImage = GIFAnimatedImage(from: imageSource, for: info, options: options) else { + return nil + } + var image: KFCrossPlatformImage? + if options.onlyFirstFrame { + image = animatedImage.images.first + } else { + image = KFCrossPlatformImage(data: data) + var kf = image?.kf + kf?.images = animatedImage.images + kf?.duration = animatedImage.duration + } + image?.kf.animatedImageData = data + image?.kf.imageFrameCount = Int(CGImageSourceGetCount(imageSource)) + return image + #else + + var image: KFCrossPlatformImage? + if options.preloadAll || options.onlyFirstFrame { + // Use `images` image if you want to preload all animated data + guard let animatedImage = GIFAnimatedImage(from: imageSource, for: info, options: options) else { + return nil + } + if options.onlyFirstFrame { + image = animatedImage.images.first + } else { + let duration = options.duration <= 0.0 ? animatedImage.duration : options.duration + image = .animatedImage(with: animatedImage.images, duration: duration) + } + image?.kf.animatedImageData = data + } else { + image = KFCrossPlatformImage(data: data, scale: options.scale) + var kf = image?.kf + kf?.imageSource = imageSource + kf?.animatedImageData = data + } + + image?.kf.imageFrameCount = Int(CGImageSourceGetCount(imageSource)) + return image + #endif + } + + /// Creates an image from a given data and options. `.JPEG`, `.PNG` or `.GIF` is supported. For other + /// image format, image initializer from system will be used. If no image object could be created from + /// the given `data`, `nil` will be returned. + /// + /// - Parameters: + /// - data: The image data representation. + /// - options: Options to use when creating the image. + /// - Returns: An `Image` object represents the image if created. If the `data` is invalid or not supported, `nil` + /// will be returned. + public static func image(data: Data, options: ImageCreatingOptions) -> KFCrossPlatformImage? { + var image: KFCrossPlatformImage? + switch data.kf.imageFormat { + case .JPEG: + image = KFCrossPlatformImage(data: data, scale: options.scale) + case .PNG: + image = KFCrossPlatformImage(data: data, scale: options.scale) + case .GIF: + image = KingfisherWrapper.animatedImage(data: data, options: options) + case .unknown: + image = KFCrossPlatformImage(data: data, scale: options.scale) + } + return image + } + + /// Creates a downsampled image from given data to a certain size and scale. + /// + /// - Parameters: + /// - data: The image data contains a JPEG or PNG image. + /// - pointSize: The target size in point to which the image should be downsampled. + /// - scale: The scale of result image. + /// - Returns: A downsampled `Image` object following the input conditions. + /// + /// - Note: + /// Different from image `resize` methods, downsampling will not render the original + /// input image in pixel format. It does downsampling from the image data, so it is much + /// more memory efficient and friendly. Choose to use downsampling as possible as you can. + /// + /// The pointsize should be smaller than the size of input image. If it is larger than the + /// original image size, the result image will be the same size of input without downsampling. + public static func downsampledImage(data: Data, to pointSize: CGSize, scale: CGFloat) -> KFCrossPlatformImage? { + let imageSourceOptions = [kCGImageSourceShouldCache: false] as CFDictionary + guard let imageSource = CGImageSourceCreateWithData(data as CFData, imageSourceOptions) else { + return nil + } + + let maxDimensionInPixels = max(pointSize.width, pointSize.height) * scale + let downsampleOptions = [ + kCGImageSourceCreateThumbnailFromImageAlways: true, + kCGImageSourceShouldCacheImmediately: true, + kCGImageSourceCreateThumbnailWithTransform: true, + kCGImageSourceThumbnailMaxPixelSize: maxDimensionInPixels] as CFDictionary + guard let downsampledImage = CGImageSourceCreateThumbnailAtIndex(imageSource, 0, downsampleOptions) else { + return nil + } + return KingfisherWrapper.image(cgImage: downsampledImage, scale: scale, refImage: nil) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Image/ImageDrawing.swift b/Demo/Pods/Kingfisher/Sources/Image/ImageDrawing.swift new file mode 100644 index 0000000..63f135a --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/ImageDrawing.swift @@ -0,0 +1,636 @@ +// +// ImageDrawing.swift +// Kingfisher +// +// Created by onevcat on 2018/09/28. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Accelerate + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) +import AppKit +#endif +#if canImport(UIKit) +import UIKit +#endif + +// MARK: - Image Transforming +extension KingfisherWrapper where Base: KFCrossPlatformImage { + // MARK: Blend Mode + /// Create image from `base` image and apply blend mode. + /// + /// - parameter blendMode: The blend mode of creating image. + /// - parameter alpha: The alpha should be used for image. + /// - parameter backgroundColor: The background color for the output image. + /// + /// - returns: An image with blend mode applied. + /// + /// - Note: This method only works for CG-based image. + #if !os(macOS) + public func image(withBlendMode blendMode: CGBlendMode, + alpha: CGFloat = 1.0, + backgroundColor: KFCrossPlatformColor? = nil) -> KFCrossPlatformImage + { + guard let _ = cgImage else { + assertionFailure("[Kingfisher] Blend mode image only works for CG-based image.") + return base + } + + let rect = CGRect(origin: .zero, size: size) + return draw(to: rect.size, inverting: false) { _ in + if let backgroundColor = backgroundColor { + backgroundColor.setFill() + UIRectFill(rect) + } + + base.draw(in: rect, blendMode: blendMode, alpha: alpha) + return false + } + } + #endif + + #if os(macOS) + // MARK: Compositing + /// Creates image from `base` image and apply compositing operation. + /// + /// - Parameters: + /// - compositingOperation: The compositing operation of creating image. + /// - alpha: The alpha should be used for image. + /// - backgroundColor: The background color for the output image. + /// - Returns: An image with compositing operation applied. + /// + /// - Note: This method only works for CG-based image. For any non-CG-based image, `base` itself is returned. + public func image(withCompositingOperation compositingOperation: NSCompositingOperation, + alpha: CGFloat = 1.0, + backgroundColor: KFCrossPlatformColor? = nil) -> KFCrossPlatformImage + { + guard let _ = cgImage else { + assertionFailure("[Kingfisher] Compositing Operation image only works for CG-based image.") + return base + } + + let rect = CGRect(origin: .zero, size: size) + return draw(to: rect.size, inverting: false) { _ in + if let backgroundColor = backgroundColor { + backgroundColor.setFill() + rect.fill() + } + base.draw(in: rect, from: .zero, operation: compositingOperation, fraction: alpha) + return false + } + } + #endif + + // MARK: Round Corner + + /// Creates a round corner image from on `base` image. + /// + /// - Parameters: + /// - radius: The round corner radius of creating image. + /// - size: The target size of creating image. + /// - corners: The target corners which will be applied rounding. + /// - backgroundColor: The background color for the output image + /// - Returns: An image with round corner of `self`. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image, `base` itself is returned. + public func image( + withRadius radius: Radius, + fit size: CGSize, + roundingCorners corners: RectCorner = .all, + backgroundColor: KFCrossPlatformColor? = nil + ) -> KFCrossPlatformImage + { + + guard let _ = cgImage else { + assertionFailure("[Kingfisher] Round corner image only works for CG-based image.") + return base + } + + let rect = CGRect(origin: CGPoint(x: 0, y: 0), size: size) + return draw(to: size, inverting: false) { _ in + #if os(macOS) + if let backgroundColor = backgroundColor { + let rectPath = NSBezierPath(rect: rect) + backgroundColor.setFill() + rectPath.fill() + } + + let path = pathForRoundCorner(rect: rect, radius: radius, corners: corners) + path.addClip() + base.draw(in: rect) + #else + guard let context = UIGraphicsGetCurrentContext() else { + assertionFailure("[Kingfisher] Failed to create CG context for image.") + return false + } + + if let backgroundColor = backgroundColor { + let rectPath = UIBezierPath(rect: rect) + backgroundColor.setFill() + rectPath.fill() + } + + let path = pathForRoundCorner(rect: rect, radius: radius, corners: corners) + context.addPath(path.cgPath) + context.clip() + base.draw(in: rect) + #endif + return false + } + } + + /// Creates a round corner image from on `base` image. + /// + /// - Parameters: + /// - radius: The round corner radius of creating image. + /// - size: The target size of creating image. + /// - corners: The target corners which will be applied rounding. + /// - backgroundColor: The background color for the output image + /// - Returns: An image with round corner of `self`. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image, `base` itself is returned. + public func image( + withRoundRadius radius: CGFloat, + fit size: CGSize, + roundingCorners corners: RectCorner = .all, + backgroundColor: KFCrossPlatformColor? = nil + ) -> KFCrossPlatformImage + { + image(withRadius: .point(radius), fit: size, roundingCorners: corners, backgroundColor: backgroundColor) + } + + #if os(macOS) + func pathForRoundCorner(rect: CGRect, radius: Radius, corners: RectCorner, offsetBase: CGFloat = 0) -> NSBezierPath { + let cornerRadius = radius.compute(with: rect.size) + let path = NSBezierPath(roundedRect: rect, byRoundingCorners: corners, radius: cornerRadius - offsetBase / 2) + path.windingRule = .evenOdd + return path + } + #else + func pathForRoundCorner(rect: CGRect, radius: Radius, corners: RectCorner, offsetBase: CGFloat = 0) -> UIBezierPath { + let cornerRadius = radius.compute(with: rect.size) + return UIBezierPath( + roundedRect: rect, + byRoundingCorners: corners.uiRectCorner, + cornerRadii: CGSize( + width: cornerRadius - offsetBase / 2, + height: cornerRadius - offsetBase / 2 + ) + ) + } + #endif + + #if os(iOS) || os(tvOS) + func resize(to size: CGSize, for contentMode: UIView.ContentMode) -> KFCrossPlatformImage { + switch contentMode { + case .scaleAspectFit: + return resize(to: size, for: .aspectFit) + case .scaleAspectFill: + return resize(to: size, for: .aspectFill) + default: + return resize(to: size) + } + } + #endif + + // MARK: Resizing + /// Resizes `base` image to an image with new size. + /// + /// - Parameter size: The target size in point. + /// - Returns: An image with new size. + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image, `base` itself is returned. + public func resize(to size: CGSize) -> KFCrossPlatformImage { + guard let _ = cgImage else { + assertionFailure("[Kingfisher] Resize only works for CG-based image.") + return base + } + + let rect = CGRect(origin: CGPoint(x: 0, y: 0), size: size) + return draw(to: size, inverting: false) { _ in + #if os(macOS) + base.draw(in: rect, from: .zero, operation: .copy, fraction: 1.0) + #else + base.draw(in: rect) + #endif + return false + } + } + + /// Resizes `base` image to an image of new size, respecting the given content mode. + /// + /// - Parameters: + /// - targetSize: The target size in point. + /// - contentMode: Content mode of output image should be. + /// - Returns: An image with new size. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image, `base` itself is returned. + public func resize(to targetSize: CGSize, for contentMode: ContentMode) -> KFCrossPlatformImage { + let newSize = size.kf.resize(to: targetSize, for: contentMode) + return resize(to: newSize) + } + + // MARK: Cropping + /// Crops `base` image to a new size with a given anchor. + /// + /// - Parameters: + /// - size: The target size. + /// - anchor: The anchor point from which the size should be calculated. + /// - Returns: An image with new size. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image, `base` itself is returned. + public func crop(to size: CGSize, anchorOn anchor: CGPoint) -> KFCrossPlatformImage { + guard let cgImage = cgImage else { + assertionFailure("[Kingfisher] Crop only works for CG-based image.") + return base + } + + let rect = self.size.kf.constrainedRect(for: size, anchor: anchor) + guard let image = cgImage.cropping(to: rect.scaled(scale)) else { + assertionFailure("[Kingfisher] Cropping image failed.") + return base + } + + return KingfisherWrapper.image(cgImage: image, scale: scale, refImage: base) + } + + // MARK: Blur + /// Creates an image with blur effect based on `base` image. + /// + /// - Parameter radius: The blur radius should be used when creating blur effect. + /// - Returns: An image with blur effect applied. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image, `base` itself is returned. + public func blurred(withRadius radius: CGFloat) -> KFCrossPlatformImage { + + guard let cgImage = cgImage else { + assertionFailure("[Kingfisher] Blur only works for CG-based image.") + return base + } + + // http://www.w3.org/TR/SVG/filters.html#feGaussianBlurElement + // let d = floor(s * 3*sqrt(2*pi)/4 + 0.5) + // if d is odd, use three box-blurs of size 'd', centered on the output pixel. + let s = max(radius, 2.0) + // We will do blur on a resized image (*0.5), so the blur radius could be half as well. + + // Fix the slow compiling time for Swift 3. + // See https://github.com/onevcat/Kingfisher/issues/611 + let pi2 = 2 * CGFloat.pi + let sqrtPi2 = sqrt(pi2) + var targetRadius = floor(s * 3.0 * sqrtPi2 / 4.0 + 0.5) + + if targetRadius.isEven { targetRadius += 1 } + + // Determine necessary iteration count by blur radius. + let iterations: Int + if radius < 0.5 { + iterations = 1 + } else if radius < 1.5 { + iterations = 2 + } else { + iterations = 3 + } + + let w = Int(size.width) + let h = Int(size.height) + + func createEffectBuffer(_ context: CGContext) -> vImage_Buffer { + let data = context.data + let width = vImagePixelCount(context.width) + let height = vImagePixelCount(context.height) + let rowBytes = context.bytesPerRow + + return vImage_Buffer(data: data, height: height, width: width, rowBytes: rowBytes) + } + GraphicsContext.begin(size: size, scale: scale) + guard let context = GraphicsContext.current(size: size, scale: scale, inverting: true, cgImage: cgImage) else { + assertionFailure("[Kingfisher] Failed to create CG context for blurring image.") + return base + } + context.draw(cgImage, in: CGRect(x: 0, y: 0, width: w, height: h)) + GraphicsContext.end() + + var inBuffer = createEffectBuffer(context) + + GraphicsContext.begin(size: size, scale: scale) + guard let outContext = GraphicsContext.current(size: size, scale: scale, inverting: true, cgImage: cgImage) else { + assertionFailure("[Kingfisher] Failed to create CG context for blurring image.") + return base + } + defer { GraphicsContext.end() } + var outBuffer = createEffectBuffer(outContext) + + for _ in 0 ..< iterations { + let flag = vImage_Flags(kvImageEdgeExtend) + vImageBoxConvolve_ARGB8888( + &inBuffer, &outBuffer, nil, 0, 0, UInt32(targetRadius), UInt32(targetRadius), nil, flag) + // Next inBuffer should be the outButter of current iteration + (inBuffer, outBuffer) = (outBuffer, inBuffer) + } + + #if os(macOS) + let result = outContext.makeImage().flatMap { + fixedForRetinaPixel(cgImage: $0, to: size) + } + #else + let result = outContext.makeImage().flatMap { + KFCrossPlatformImage(cgImage: $0, scale: base.scale, orientation: base.imageOrientation) + } + #endif + guard let blurredImage = result else { + assertionFailure("[Kingfisher] Can not make an blurred image within this context.") + return base + } + + return blurredImage + } + + public func addingBorder(_ border: Border) -> KFCrossPlatformImage + { + guard let _ = cgImage else { + assertionFailure("[Kingfisher] Blend mode image only works for CG-based image.") + return base + } + + let rect = CGRect(origin: .zero, size: size) + return draw(to: rect.size, inverting: false) { context in + + #if os(macOS) + base.draw(in: rect) + #else + base.draw(in: rect, blendMode: .normal, alpha: 1.0) + #endif + + + let strokeRect = rect.insetBy(dx: border.lineWidth / 2, dy: border.lineWidth / 2) + context.setStrokeColor(border.color.cgColor) + context.setAlpha(border.color.rgba.a) + + let line = pathForRoundCorner( + rect: strokeRect, + radius: border.radius, + corners: border.roundingCorners, + offsetBase: border.lineWidth + ) + line.lineCapStyle = .square + line.lineWidth = border.lineWidth + line.stroke() + + return false + } + } + + // MARK: Overlay + /// Creates an image from `base` image with a color overlay layer. + /// + /// - Parameters: + /// - color: The color should be use to overlay. + /// - fraction: Fraction of input color. From 0.0 to 1.0. 0.0 means solid color, + /// 1.0 means transparent overlay. + /// - Returns: An image with a color overlay applied. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image, `base` itself is returned. + public func overlaying(with color: KFCrossPlatformColor, fraction: CGFloat) -> KFCrossPlatformImage { + + guard let _ = cgImage else { + assertionFailure("[Kingfisher] Overlaying only works for CG-based image.") + return base + } + + let rect = CGRect(x: 0, y: 0, width: size.width, height: size.height) + return draw(to: rect.size, inverting: false) { context in + #if os(macOS) + base.draw(in: rect) + if fraction > 0 { + color.withAlphaComponent(1 - fraction).set() + rect.fill(using: .sourceAtop) + } + #else + color.set() + UIRectFill(rect) + base.draw(in: rect, blendMode: .destinationIn, alpha: 1.0) + + if fraction > 0 { + base.draw(in: rect, blendMode: .sourceAtop, alpha: fraction) + } + #endif + return false + } + } + + // MARK: Tint + /// Creates an image from `base` image with a color tint. + /// + /// - Parameter color: The color should be used to tint `base` + /// - Returns: An image with a color tint applied. + public func tinted(with color: KFCrossPlatformColor) -> KFCrossPlatformImage { + #if os(watchOS) + return base + #else + return apply(.tint(color)) + #endif + } + + // MARK: Color Control + + /// Create an image from `self` with color control. + /// + /// - Parameters: + /// - brightness: Brightness changing to image. + /// - contrast: Contrast changing to image. + /// - saturation: Saturation changing to image. + /// - inputEV: InputEV changing to image. + /// - Returns: An image with color control applied. + public func adjusted(brightness: CGFloat, contrast: CGFloat, saturation: CGFloat, inputEV: CGFloat) -> KFCrossPlatformImage { + #if os(watchOS) + return base + #else + return apply(.colorControl((brightness, contrast, saturation, inputEV))) + #endif + } + + /// Return an image with given scale. + /// + /// - Parameter scale: Target scale factor the new image should have. + /// - Returns: The image with target scale. If the base image is already in the scale, `base` will be returned. + public func scaled(to scale: CGFloat) -> KFCrossPlatformImage { + guard scale != self.scale else { + return base + } + guard let cgImage = cgImage else { + assertionFailure("[Kingfisher] Scaling only works for CG-based image.") + return base + } + return KingfisherWrapper.image(cgImage: cgImage, scale: scale, refImage: base) + } +} + +// MARK: - Decoding Image +extension KingfisherWrapper where Base: KFCrossPlatformImage { + + /// Returns the decoded image of the `base` image. It will draw the image in a plain context and return the data + /// from it. This could improve the drawing performance when an image is just created from data but not yet + /// displayed for the first time. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image or animated image, `base` itself is returned. + public var decoded: KFCrossPlatformImage { return decoded(scale: scale) } + + /// Returns decoded image of the `base` image at a given scale. It will draw the image in a plain context and + /// return the data from it. This could improve the drawing performance when an image is just created from + /// data but not yet displayed for the first time. + /// + /// - Parameter scale: The given scale of target image should be. + /// - Returns: The decoded image ready to be displayed. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image or animated image, `base` itself is returned. + public func decoded(scale: CGFloat) -> KFCrossPlatformImage { + // Prevent animated image (GIF) losing it's images + #if os(iOS) + if imageSource != nil { return base } + #else + if images != nil { return base } + #endif + + guard let imageRef = cgImage else { + assertionFailure("[Kingfisher] Decoding only works for CG-based image.") + return base + } + + let size = CGSize(width: CGFloat(imageRef.width) / scale, height: CGFloat(imageRef.height) / scale) + return draw(to: size, inverting: true, scale: scale) { context in + context.draw(imageRef, in: CGRect(origin: .zero, size: size)) + return true + } + } + + /// Returns decoded image of the `base` image at a given scale. It will draw the image in a plain context and + /// return the data from it. This could improve the drawing performance when an image is just created from + /// data but not yet displayed for the first time. + /// + /// - Parameter context: The context for drawing. + /// - Returns: The decoded image ready to be displayed. + /// + /// - Note: This method only works for CG-based image. The current image scale is kept. + /// For any non-CG-based image or animated image, `base` itself is returned. + public func decoded(on context: CGContext) -> KFCrossPlatformImage { + // Prevent animated image (GIF) losing it's images + #if os(iOS) + if imageSource != nil { return base } + #else + if images != nil { return base } + #endif + + guard let refImage = cgImage, + let decodedRefImage = refImage.decoded(on: context, scale: scale) else + { + assertionFailure("[Kingfisher] Decoding only works for CG-based image.") + return base + } + return KingfisherWrapper.image(cgImage: decodedRefImage, scale: scale, refImage: base) + } +} + +extension CGImage { + func decoded(on context: CGContext, scale: CGFloat) -> CGImage? { + let size = CGSize(width: CGFloat(self.width) / scale, height: CGFloat(self.height) / scale) + context.draw(self, in: CGRect(origin: .zero, size: size)) + guard let decodedImageRef = context.makeImage() else { + return nil + } + return decodedImageRef + } +} + +extension KingfisherWrapper where Base: KFCrossPlatformImage { + func draw( + to size: CGSize, + inverting: Bool, + scale: CGFloat? = nil, + refImage: KFCrossPlatformImage? = nil, + draw: (CGContext) -> Bool // Whether use the refImage (`true`) or ignore image orientation (`false`) + ) -> KFCrossPlatformImage + { + #if os(macOS) || os(watchOS) + let targetScale = scale ?? self.scale + GraphicsContext.begin(size: size, scale: targetScale) + guard let context = GraphicsContext.current(size: size, scale: targetScale, inverting: inverting, cgImage: cgImage) else { + assertionFailure("[Kingfisher] Failed to create CG context for blurring image.") + return base + } + defer { GraphicsContext.end() } + let useRefImage = draw(context) + guard let cgImage = context.makeImage() else { + return base + } + let ref = useRefImage ? (refImage ?? base) : nil + return KingfisherWrapper.image(cgImage: cgImage, scale: targetScale, refImage: ref) + #else + + let format = UIGraphicsImageRendererFormat.preferred() + format.scale = scale ?? self.scale + let renderer = UIGraphicsImageRenderer(size: size, format: format) + + var useRefImage: Bool = false + let image = renderer.image { rendererContext in + + let context = rendererContext.cgContext + if inverting { // If drawing a CGImage, we need to make context flipped. + context.scaleBy(x: 1.0, y: -1.0) + context.translateBy(x: 0, y: -size.height) + } + + useRefImage = draw(context) + } + if useRefImage { + guard let cgImage = image.cgImage else { + return base + } + let ref = refImage ?? base + return KingfisherWrapper.image(cgImage: cgImage, scale: format.scale, refImage: ref) + } else { + return image + } + #endif + } + + #if os(macOS) + func fixedForRetinaPixel(cgImage: CGImage, to size: CGSize) -> KFCrossPlatformImage { + + let image = KFCrossPlatformImage(cgImage: cgImage, size: base.size) + let rect = CGRect(origin: CGPoint(x: 0, y: 0), size: size) + + return draw(to: self.size, inverting: false) { context in + image.draw(in: rect, from: .zero, operation: .copy, fraction: 1.0) + return false + } + } + #endif +} diff --git a/Demo/Pods/Kingfisher/Sources/Image/ImageFormat.swift b/Demo/Pods/Kingfisher/Sources/Image/ImageFormat.swift new file mode 100644 index 0000000..464a855 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/ImageFormat.swift @@ -0,0 +1,130 @@ +// +// ImageFormat.swift +// Kingfisher +// +// Created by onevcat on 2018/09/28. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents image format. +/// +/// - unknown: The format cannot be recognized or not supported yet. +/// - PNG: PNG image format. +/// - JPEG: JPEG image format. +/// - GIF: GIF image format. +public enum ImageFormat { + /// The format cannot be recognized or not supported yet. + case unknown + /// PNG image format. + case PNG + /// JPEG image format. + case JPEG + /// GIF image format. + case GIF + + struct HeaderData { + static var PNG: [UInt8] = [0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A] + static var JPEG_SOI: [UInt8] = [0xFF, 0xD8] + static var JPEG_IF: [UInt8] = [0xFF] + static var GIF: [UInt8] = [0x47, 0x49, 0x46] + } + + /// https://en.wikipedia.org/wiki/JPEG + public enum JPEGMarker { + case SOF0 //baseline + case SOF2 //progressive + case DHT //Huffman Table + case DQT //Quantization Table + case DRI //Restart Interval + case SOS //Start Of Scan + case RSTn(UInt8) //Restart + case APPn //Application-specific + case COM //Comment + case EOI //End Of Image + + var bytes: [UInt8] { + switch self { + case .SOF0: return [0xFF, 0xC0] + case .SOF2: return [0xFF, 0xC2] + case .DHT: return [0xFF, 0xC4] + case .DQT: return [0xFF, 0xDB] + case .DRI: return [0xFF, 0xDD] + case .SOS: return [0xFF, 0xDA] + case .RSTn(let n): return [0xFF, 0xD0 + n] + case .APPn: return [0xFF, 0xE0] + case .COM: return [0xFF, 0xFE] + case .EOI: return [0xFF, 0xD9] + } + } + } +} + + +extension Data: KingfisherCompatibleValue {} + +// MARK: - Misc Helpers +extension KingfisherWrapper where Base == Data { + /// Gets the image format corresponding to the data. + public var imageFormat: ImageFormat { + guard base.count > 8 else { return .unknown } + + var buffer = [UInt8](repeating: 0, count: 8) + base.copyBytes(to: &buffer, count: 8) + + if buffer == ImageFormat.HeaderData.PNG { + return .PNG + + } else if buffer[0] == ImageFormat.HeaderData.JPEG_SOI[0], + buffer[1] == ImageFormat.HeaderData.JPEG_SOI[1], + buffer[2] == ImageFormat.HeaderData.JPEG_IF[0] + { + return .JPEG + + } else if buffer[0] == ImageFormat.HeaderData.GIF[0], + buffer[1] == ImageFormat.HeaderData.GIF[1], + buffer[2] == ImageFormat.HeaderData.GIF[2] + { + return .GIF + } + + return .unknown + } + + public func contains(jpeg marker: ImageFormat.JPEGMarker) -> Bool { + guard imageFormat == .JPEG else { + return false + } + + let bytes = [UInt8](base) + let markerBytes = marker.bytes + for (index, item) in bytes.enumerated() where bytes.count > index + 1 { + guard + item == markerBytes.first, + bytes[index + 1] == markerBytes[1] else { + continue + } + return true + } + return false + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Image/ImageProcessor.swift b/Demo/Pods/Kingfisher/Sources/Image/ImageProcessor.swift new file mode 100644 index 0000000..60798a9 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/ImageProcessor.swift @@ -0,0 +1,920 @@ +// +// ImageProcessor.swift +// Kingfisher +// +// Created by Wei Wang on 2016/08/26. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import CoreGraphics + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) +import AppKit +#endif + +/// Represents an item which could be processed by an `ImageProcessor`. +/// +/// - image: Input image. The processor should provide a way to apply +/// processing on this `image` and return the result image. +/// - data: Input data. The processor should provide a way to apply +/// processing on this `data` and return the result image. +public enum ImageProcessItem { + + /// Input image. The processor should provide a way to apply + /// processing on this `image` and return the result image. + case image(KFCrossPlatformImage) + + /// Input data. The processor should provide a way to apply + /// processing on this `data` and return the result image. + case data(Data) +} + +/// An `ImageProcessor` would be used to convert some downloaded data to an image. +public protocol ImageProcessor { + /// Identifier of the processor. It will be used to identify the processor when + /// caching and retrieving an image. You might want to make sure that processors with + /// same properties/functionality have the same identifiers, so correct processed images + /// could be retrieved with proper key. + /// + /// - Note: Do not supply an empty string for a customized processor, which is already reserved by + /// the `DefaultImageProcessor`. It is recommended to use a reverse domain name notation string of + /// your own for the identifier. + var identifier: String { get } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: The parsed options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: The return value should be `nil` if processing failed while converting an input item to image. + /// If `nil` received by the processing caller, an error will be reported and the process flow stops. + /// If the processing flow is not critical for your flow, then when the input item is already an image + /// (`.image` case) and there is any errors in the processing, you could return the input image itself + /// to keep the processing pipeline continuing. + /// - Note: Most processor only supports CG-based images. watchOS is not supported for processors containing + /// a filter, the input image will be returned directly on watchOS. + func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? +} + +extension ImageProcessor { + + /// Appends an `ImageProcessor` to another. The identifier of the new `ImageProcessor` + /// will be "\(self.identifier)|>\(another.identifier)". + /// + /// - Parameter another: An `ImageProcessor` you want to append to `self`. + /// - Returns: The new `ImageProcessor` will process the image in the order + /// of the two processors concatenated. + public func append(another: ImageProcessor) -> ImageProcessor { + let newIdentifier = identifier.appending("|>\(another.identifier)") + return GeneralProcessor(identifier: newIdentifier) { + item, options in + if let image = self.process(item: item, options: options) { + return another.process(item: .image(image), options: options) + } else { + return nil + } + } + } +} + +func ==(left: ImageProcessor, right: ImageProcessor) -> Bool { + return left.identifier == right.identifier +} + +func !=(left: ImageProcessor, right: ImageProcessor) -> Bool { + return !(left == right) +} + +typealias ProcessorImp = ((ImageProcessItem, KingfisherParsedOptionsInfo) -> KFCrossPlatformImage?) +struct GeneralProcessor: ImageProcessor { + let identifier: String + let p: ProcessorImp + func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + return p(item, options) + } +} + +/// The default processor. It converts the input data to a valid image. +/// Images of .PNG, .JPEG and .GIF format are supported. +/// If an image item is given as `.image` case, `DefaultImageProcessor` will +/// do nothing on it and return the associated image. +public struct DefaultImageProcessor: ImageProcessor { + + /// A default `DefaultImageProcessor` could be used across. + public static let `default` = DefaultImageProcessor() + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier = "" + + /// Creates a `DefaultImageProcessor`. Use `DefaultImageProcessor.default` to get an instance, + /// if you do not have a good reason to create your own `DefaultImageProcessor`. + public init() {} + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + case .data(let data): + return KingfisherWrapper.image(data: data, options: options.imageCreatingOptions) + } + } +} + +/// Represents the rect corner setting when processing a round corner image. +public struct RectCorner: OptionSet { + + /// Raw value of the rect corner. + public let rawValue: Int + + /// Represents the top left corner. + public static let topLeft = RectCorner(rawValue: 1 << 0) + + /// Represents the top right corner. + public static let topRight = RectCorner(rawValue: 1 << 1) + + /// Represents the bottom left corner. + public static let bottomLeft = RectCorner(rawValue: 1 << 2) + + /// Represents the bottom right corner. + public static let bottomRight = RectCorner(rawValue: 1 << 3) + + /// Represents all corners. + public static let all: RectCorner = [.topLeft, .topRight, .bottomLeft, .bottomRight] + + /// Creates a `RectCorner` option set with a given value. + /// + /// - Parameter rawValue: The value represents a certain corner option. + public init(rawValue: Int) { + self.rawValue = rawValue + } + + var cornerIdentifier: String { + if self == .all { + return "" + } + return "_corner(\(rawValue))" + } +} + +#if !os(macOS) +/// Processor for adding an blend mode to images. Only CG-based images are supported. +public struct BlendImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Blend Mode will be used to blend the input image. + public let blendMode: CGBlendMode + + /// Alpha will be used when blend image. + public let alpha: CGFloat + + /// Background color of the output image. If `nil`, it will stay transparent. + public let backgroundColor: KFCrossPlatformColor? + + /// Creates a `BlendImageProcessor`. + /// + /// - Parameters: + /// - blendMode: Blend Mode will be used to blend the input image. + /// - alpha: Alpha will be used when blend image. From 0.0 to 1.0. 1.0 means solid image, + /// 0.0 means transparent image (not visible at all). Default is 1.0. + /// - backgroundColor: Background color to apply for the output image. Default is `nil`. + public init(blendMode: CGBlendMode, alpha: CGFloat = 1.0, backgroundColor: KFCrossPlatformColor? = nil) { + self.blendMode = blendMode + self.alpha = alpha + self.backgroundColor = backgroundColor + var identifier = "com.onevcat.Kingfisher.BlendImageProcessor(\(blendMode.rawValue),\(alpha))" + if let color = backgroundColor { + identifier.append("_\(color.rgbaDescription)") + } + self.identifier = identifier + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + .kf.image(withBlendMode: blendMode, alpha: alpha, backgroundColor: backgroundColor) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} +#endif + +#if os(macOS) +/// Processor for adding an compositing operation to images. Only CG-based images are supported in macOS. +public struct CompositingImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Compositing operation will be used to the input image. + public let compositingOperation: NSCompositingOperation + + /// Alpha will be used when compositing image. + public let alpha: CGFloat + + /// Background color of the output image. If `nil`, it will stay transparent. + public let backgroundColor: KFCrossPlatformColor? + + /// Creates a `CompositingImageProcessor` + /// + /// - Parameters: + /// - compositingOperation: Compositing operation will be used to the input image. + /// - alpha: Alpha will be used when compositing image. + /// From 0.0 to 1.0. 1.0 means solid image, 0.0 means transparent image. + /// Default is 1.0. + /// - backgroundColor: Background color to apply for the output image. Default is `nil`. + public init(compositingOperation: NSCompositingOperation, + alpha: CGFloat = 1.0, + backgroundColor: KFCrossPlatformColor? = nil) + { + self.compositingOperation = compositingOperation + self.alpha = alpha + self.backgroundColor = backgroundColor + var identifier = "com.onevcat.Kingfisher.CompositingImageProcessor(\(compositingOperation.rawValue),\(alpha))" + if let color = backgroundColor { + identifier.append("_\(color.rgbaDescription)") + } + self.identifier = identifier + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + .kf.image( + withCompositingOperation: compositingOperation, + alpha: alpha, + backgroundColor: backgroundColor) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} +#endif + +/// Represents a radius specified in a `RoundCornerImageProcessor`. +public enum Radius { + /// The radius should be calculated as a fraction of the image width. Typically the associated value should be + /// between 0 and 0.5, where 0 represents no radius and 0.5 represents using half of the image width. + case widthFraction(CGFloat) + /// The radius should be calculated as a fraction of the image height. Typically the associated value should be + /// between 0 and 0.5, where 0 represents no radius and 0.5 represents using half of the image height. + case heightFraction(CGFloat) + /// Use a fixed point value as the round corner radius. + case point(CGFloat) + + var radiusIdentifier: String { + switch self { + case .widthFraction(let f): + return "w_frac_\(f)" + case .heightFraction(let f): + return "h_frac_\(f)" + case .point(let p): + return p.description + } + } + + public func compute(with size: CGSize) -> CGFloat { + let cornerRadius: CGFloat + switch self { + case .point(let point): + cornerRadius = point + case .widthFraction(let widthFraction): + cornerRadius = size.width * widthFraction + case .heightFraction(let heightFraction): + cornerRadius = size.height * heightFraction + } + return cornerRadius + } +} + +/// Processor for making round corner images. Only CG-based images are supported in macOS, +/// if a non-CG image passed in, the processor will do nothing. +/// +/// - Note: The input image will be rendered with round corner pixels removed. If the image itself does not contain +/// alpha channel (for example, a JPEG image), the processed image will contain an alpha channel in memory in order +/// to show correctly. However, when cached to disk, Kingfisher respects the original image format by default. That +/// means the alpha channel will be removed for these images. When you load the processed image from cache again, you +/// will lose transparent corner. +/// +/// You could use `FormatIndicatedCacheSerializer.png` to force Kingfisher to serialize the image to PNG format in this +/// case. +/// +public struct RoundCornerImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// The radius will be applied in processing. Specify a certain point value with `.point`, or a fraction of the + /// target image with `.widthFraction`. or `.heightFraction`. For example, given a square image with width and + /// height equals, `.widthFraction(0.5)` means use half of the length of size and makes the final image a round one. + public let radius: Radius + + /// The target corners which will be applied rounding. + public let roundingCorners: RectCorner + + /// Target size of output image should be. If `nil`, the image will keep its original size after processing. + public let targetSize: CGSize? + + /// Background color of the output image. If `nil`, it will use a transparent background. + public let backgroundColor: KFCrossPlatformColor? + + /// Creates a `RoundCornerImageProcessor`. + /// + /// - Parameters: + /// - cornerRadius: Corner radius in point will be applied in processing. + /// - targetSize: Target size of output image should be. If `nil`, + /// the image will keep its original size after processing. + /// Default is `nil`. + /// - corners: The target corners which will be applied rounding. Default is `.all`. + /// - backgroundColor: Background color to apply for the output image. Default is `nil`. + /// + /// - Note: + /// + /// This initializer accepts a concrete point value for `cornerRadius`. If you do not know the image size, but still + /// want to apply a full round-corner (making the final image a round one), or specify the corner radius as a + /// fraction of one dimension of the target image, use the `Radius` version instead. + /// + public init( + cornerRadius: CGFloat, + targetSize: CGSize? = nil, + roundingCorners corners: RectCorner = .all, + backgroundColor: KFCrossPlatformColor? = nil + ) + { + let radius = Radius.point(cornerRadius) + self.init(radius: radius, targetSize: targetSize, roundingCorners: corners, backgroundColor: backgroundColor) + } + + /// Creates a `RoundCornerImageProcessor`. + /// + /// - Parameters: + /// - radius: The radius will be applied in processing. + /// - targetSize: Target size of output image should be. If `nil`, + /// the image will keep its original size after processing. + /// Default is `nil`. + /// - corners: The target corners which will be applied rounding. Default is `.all`. + /// - backgroundColor: Background color to apply for the output image. Default is `nil`. + public init( + radius: Radius, + targetSize: CGSize? = nil, + roundingCorners corners: RectCorner = .all, + backgroundColor: KFCrossPlatformColor? = nil + ) + { + self.radius = radius + self.targetSize = targetSize + self.roundingCorners = corners + self.backgroundColor = backgroundColor + + self.identifier = { + var identifier = "" + + if let size = targetSize { + identifier = "com.onevcat.Kingfisher.RoundCornerImageProcessor" + + "(\(radius.radiusIdentifier)_\(size)\(corners.cornerIdentifier))" + } else { + identifier = "com.onevcat.Kingfisher.RoundCornerImageProcessor" + + "(\(radius.radiusIdentifier)\(corners.cornerIdentifier))" + } + if let backgroundColor = backgroundColor { + identifier += "_\(backgroundColor)" + } + + return identifier + }() + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + let size = targetSize ?? image.kf.size + return image.kf.scaled(to: options.scaleFactor) + .kf.image( + withRadius: radius, + fit: size, + roundingCorners: roundingCorners, + backgroundColor: backgroundColor) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +public struct Border { + public var color: KFCrossPlatformColor + public var lineWidth: CGFloat + + /// The radius will be applied in processing. Specify a certain point value with `.point`, or a fraction of the + /// target image with `.widthFraction`. or `.heightFraction`. For example, given a square image with width and + /// height equals, `.widthFraction(0.5)` means use half of the length of size and makes the final image a round one. + public var radius: Radius + + /// The target corners which will be applied rounding. + public var roundingCorners: RectCorner + + public init( + color: KFCrossPlatformColor = .black, + lineWidth: CGFloat = 4, + radius: Radius = .point(0), + roundingCorners: RectCorner = .all + ) { + self.color = color + self.lineWidth = lineWidth + self.radius = radius + self.roundingCorners = roundingCorners + } + + var identifier: String { + "\(color.rgbaDescription)_\(lineWidth)_\(radius.radiusIdentifier)_\(roundingCorners.cornerIdentifier)" + } +} + +public struct BorderImageProcessor: ImageProcessor { + public var identifier: String { "com.onevcat.Kingfisher.RoundCornerImageProcessor(\(border)" } + public let border: Border + + public init(border: Border) { + self.border = border + } + + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.addingBorder(border) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// Represents how a size adjusts itself to fit a target size. +/// +/// - none: Not scale the content. +/// - aspectFit: Scales the content to fit the size of the view by maintaining the aspect ratio. +/// - aspectFill: Scales the content to fill the size of the view. +public enum ContentMode { + /// Not scale the content. + case none + /// Scales the content to fit the size of the view by maintaining the aspect ratio. + case aspectFit + /// Scales the content to fill the size of the view. + case aspectFill +} + +/// Processor for resizing images. +/// If you need to resize a data represented image to a smaller size, use `DownsamplingImageProcessor` +/// instead, which is more efficient and uses less memory. +public struct ResizingImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// The reference size for resizing operation in point. + public let referenceSize: CGSize + + /// Target content mode of output image should be. + /// Default is `.none`. + public let targetContentMode: ContentMode + + /// Creates a `ResizingImageProcessor`. + /// + /// - Parameters: + /// - referenceSize: The reference size for resizing operation in point. + /// - mode: Target content mode of output image should be. + /// + /// - Note: + /// The instance of `ResizingImageProcessor` will follow its `mode` property + /// and try to resizing the input images to fit or fill the `referenceSize`. + /// That means if you are using a `mode` besides of `.none`, you may get an + /// image with its size not be the same as the `referenceSize`. + /// + /// **Example**: With input image size: {100, 200}, + /// `referenceSize`: {100, 100}, `mode`: `.aspectFit`, + /// you will get an output image with size of {50, 100}, which "fit"s + /// the `referenceSize`. + /// + /// If you need an output image exactly to be a specified size, append or use + /// a `CroppingImageProcessor`. + public init(referenceSize: CGSize, mode: ContentMode = .none) { + self.referenceSize = referenceSize + self.targetContentMode = mode + + if mode == .none { + self.identifier = "com.onevcat.Kingfisher.ResizingImageProcessor(\(referenceSize))" + } else { + self.identifier = "com.onevcat.Kingfisher.ResizingImageProcessor(\(referenceSize), \(mode))" + } + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + .kf.resize(to: referenceSize, for: targetContentMode) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// Processor for adding blur effect to images. `Accelerate.framework` is used underhood for +/// a better performance. A simulated Gaussian blur with specified blur radius will be applied. +public struct BlurImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Blur radius for the simulated Gaussian blur. + public let blurRadius: CGFloat + + /// Creates a `BlurImageProcessor` + /// + /// - parameter blurRadius: Blur radius for the simulated Gaussian blur. + public init(blurRadius: CGFloat) { + self.blurRadius = blurRadius + self.identifier = "com.onevcat.Kingfisher.BlurImageProcessor(\(blurRadius))" + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + let radius = blurRadius * options.scaleFactor + return image.kf.scaled(to: options.scaleFactor) + .kf.blurred(withRadius: radius) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// Processor for adding an overlay to images. Only CG-based images are supported in macOS. +public struct OverlayImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Overlay color will be used to overlay the input image. + public let overlay: KFCrossPlatformColor + + /// Fraction will be used when overlay the color to image. + public let fraction: CGFloat + + /// Creates an `OverlayImageProcessor` + /// + /// - parameter overlay: Overlay color will be used to overlay the input image. + /// - parameter fraction: Fraction will be used when overlay the color to image. + /// From 0.0 to 1.0. 0.0 means solid color, 1.0 means transparent overlay. + public init(overlay: KFCrossPlatformColor, fraction: CGFloat = 0.5) { + self.overlay = overlay + self.fraction = fraction + self.identifier = "com.onevcat.Kingfisher.OverlayImageProcessor(\(overlay.rgbaDescription)_\(fraction))" + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + .kf.overlaying(with: overlay, fraction: fraction) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// Processor for tint images with color. Only CG-based images are supported. +public struct TintImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Tint color will be used to tint the input image. + public let tint: KFCrossPlatformColor + + /// Creates a `TintImageProcessor` + /// + /// - parameter tint: Tint color will be used to tint the input image. + public init(tint: KFCrossPlatformColor) { + self.tint = tint + self.identifier = "com.onevcat.Kingfisher.TintImageProcessor(\(tint.rgbaDescription))" + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + .kf.tinted(with: tint) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// Processor for applying some color control to images. Only CG-based images are supported. +/// watchOS is not supported. +public struct ColorControlsProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Brightness changing to image. + public let brightness: CGFloat + + /// Contrast changing to image. + public let contrast: CGFloat + + /// Saturation changing to image. + public let saturation: CGFloat + + /// InputEV changing to image. + public let inputEV: CGFloat + + /// Creates a `ColorControlsProcessor` + /// + /// - Parameters: + /// - brightness: Brightness changing to image. + /// - contrast: Contrast changing to image. + /// - saturation: Saturation changing to image. + /// - inputEV: InputEV changing to image. + public init(brightness: CGFloat, contrast: CGFloat, saturation: CGFloat, inputEV: CGFloat) { + self.brightness = brightness + self.contrast = contrast + self.saturation = saturation + self.inputEV = inputEV + self.identifier = "com.onevcat.Kingfisher.ColorControlsProcessor(\(brightness)_\(contrast)_\(saturation)_\(inputEV))" + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + .kf.adjusted(brightness: brightness, contrast: contrast, saturation: saturation, inputEV: inputEV) + case .data: + return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// Processor for applying black and white effect to images. Only CG-based images are supported. +/// watchOS is not supported. +public struct BlackWhiteProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier = "com.onevcat.Kingfisher.BlackWhiteProcessor" + + /// Creates a `BlackWhiteProcessor` + public init() {} + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + return ColorControlsProcessor(brightness: 0.0, contrast: 1.0, saturation: 0.0, inputEV: 0.7) + .process(item: item, options: options) + } +} + +/// Processor for cropping an image. Only CG-based images are supported. +/// watchOS is not supported. +public struct CroppingImageProcessor: ImageProcessor { + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Target size of output image should be. + public let size: CGSize + + /// Anchor point from which the output size should be calculate. + /// The anchor point is consisted by two values between 0.0 and 1.0. + /// It indicates a related point in current image. + /// See `CroppingImageProcessor.init(size:anchor:)` for more. + public let anchor: CGPoint + + /// Creates a `CroppingImageProcessor`. + /// + /// - Parameters: + /// - size: Target size of output image should be. + /// - anchor: The anchor point from which the size should be calculated. + /// Default is `CGPoint(x: 0.5, y: 0.5)`, which means the center of input image. + /// - Note: + /// The anchor point is consisted by two values between 0.0 and 1.0. + /// It indicates a related point in current image, eg: (0.0, 0.0) for top-left + /// corner, (0.5, 0.5) for center and (1.0, 1.0) for bottom-right corner. + /// The `size` property of `CroppingImageProcessor` will be used along with + /// `anchor` to calculate a target rectangle in the size of image. + /// + /// The target size will be automatically calculated with a reasonable behavior. + /// For example, when you have an image size of `CGSize(width: 100, height: 100)`, + /// and a target size of `CGSize(width: 20, height: 20)`: + /// - with a (0.0, 0.0) anchor (top-left), the crop rect will be `{0, 0, 20, 20}`; + /// - with a (0.5, 0.5) anchor (center), it will be `{40, 40, 20, 20}` + /// - while with a (1.0, 1.0) anchor (bottom-right), it will be `{80, 80, 20, 20}` + public init(size: CGSize, anchor: CGPoint = CGPoint(x: 0.5, y: 0.5)) { + self.size = size + self.anchor = anchor + self.identifier = "com.onevcat.Kingfisher.CroppingImageProcessor(\(size)_\(anchor))" + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + return image.kf.scaled(to: options.scaleFactor) + .kf.crop(to: size, anchorOn: anchor) + case .data: return (DefaultImageProcessor.default |> self).process(item: item, options: options) + } + } +} + +/// Processor for downsampling an image. Compared to `ResizingImageProcessor`, this processor +/// does not render the images to resize. Instead, it downsamples the input data directly to an +/// image. It is a more efficient than `ResizingImageProcessor`. Prefer to use `DownsamplingImageProcessor` as possible +/// as you can than the `ResizingImageProcessor`. +/// +/// Only CG-based images are supported. Animated images (like GIF) is not supported. +public struct DownsamplingImageProcessor: ImageProcessor { + + /// Target size of output image should be. It should be smaller than the size of + /// input image. If it is larger, the result image will be the same size of input + /// data without downsampling. + public let size: CGSize + + /// Identifier of the processor. + /// - Note: See documentation of `ImageProcessor` protocol for more. + public let identifier: String + + /// Creates a `DownsamplingImageProcessor`. + /// + /// - Parameter size: The target size of the downsample operation. + public init(size: CGSize) { + self.size = size + self.identifier = "com.onevcat.Kingfisher.DownsamplingImageProcessor(\(size))" + } + + /// Processes the input `ImageProcessItem` with this processor. + /// + /// - Parameters: + /// - item: Input item which will be processed by `self`. + /// - options: Options when processing the item. + /// - Returns: The processed image. + /// + /// - Note: See documentation of `ImageProcessor` protocol for more. + public func process(item: ImageProcessItem, options: KingfisherParsedOptionsInfo) -> KFCrossPlatformImage? { + switch item { + case .image(let image): + guard let data = image.kf.data(format: .unknown) else { + return nil + } + return KingfisherWrapper.downsampledImage(data: data, to: size, scale: options.scaleFactor) + case .data(let data): + return KingfisherWrapper.downsampledImage(data: data, to: size, scale: options.scaleFactor) + } + } +} + +infix operator |>: AdditionPrecedence +public func |>(left: ImageProcessor, right: ImageProcessor) -> ImageProcessor { + return left.append(another: right) +} + +extension KFCrossPlatformColor { + + var rgba: (r: CGFloat, g: CGFloat, b: CGFloat, a: CGFloat) { + var r: CGFloat = 0 + var g: CGFloat = 0 + var b: CGFloat = 0 + var a: CGFloat = 0 + + #if os(macOS) + (usingColorSpace(.extendedSRGB) ?? self).getRed(&r, green: &g, blue: &b, alpha: &a) + #else + getRed(&r, green: &g, blue: &b, alpha: &a) + #endif + + return (r, g, b, a) + } + + var rgbaDescription: String { + let components = self.rgba + return String(format: "(%.2f,%.2f,%.2f,%.2f)", components.r, components.g, components.b, components.a) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Image/ImageProgressive.swift b/Demo/Pods/Kingfisher/Sources/Image/ImageProgressive.swift new file mode 100644 index 0000000..a916300 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/ImageProgressive.swift @@ -0,0 +1,348 @@ +// +// ImageProgressive.swift +// Kingfisher +// +// Created by lixiang on 2019/5/10. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import CoreGraphics + +private let sharedProcessingQueue: CallbackQueue = + .dispatch(DispatchQueue(label: "com.onevcat.Kingfisher.ImageDownloader.Process")) + +public struct ImageProgressive { + + /// The updating strategy when an intermediate progressive image is generated and about to be set to the hosting view. + /// + /// - default: Use the progressive image as it is. It is the standard behavior when handling the progressive image. + /// - keepCurrent: Discard this progressive image and keep the current displayed one. + /// - replace: Replace the image to a new one. If the progressive loading is initialized by a view extension in + /// Kingfisher, the replacing image will be used to update the view. + public enum UpdatingStrategy { + case `default` + case keepCurrent + case replace(KFCrossPlatformImage?) + } + + /// A default `ImageProgressive` could be used across. It blurs the progressive loading with the fastest + /// scan enabled and scan interval as 0. + @available(*, deprecated, message: "Getting a default `ImageProgressive` is deprecated due to its syntax symatic is not clear. Use `ImageProgressive.init` instead.", renamed: "init()") + public static let `default` = ImageProgressive( + isBlur: true, + isFastestScan: true, + scanInterval: 0 + ) + + /// Whether to enable blur effect processing + let isBlur: Bool + /// Whether to enable the fastest scan + let isFastestScan: Bool + /// Minimum time interval for each scan + let scanInterval: TimeInterval + + /// Called when an intermediate image is prepared and about to be set to the image view. The return value of this + /// delegate will be used to update the hosting view, if any. Otherwise, if there is no hosting view (a.k.a the + /// image retrieving is not happening from a view extension method), the returned `UpdatingStrategy` is ignored. + public let onImageUpdated = Delegate() + + /// Creates an `ImageProgressive` value with default sets. It blurs the progressive loading with the fastest + /// scan enabled and scan interval as 0. + public init() { + self.init(isBlur: true, isFastestScan: true, scanInterval: 0) + } + + /// Creates an `ImageProgressive` value the given values. + /// - Parameters: + /// - isBlur: Whether to enable blur effect processing. + /// - isFastestScan: Whether to enable the fastest scan. + /// - scanInterval: Minimum time interval for each scan. + public init(isBlur: Bool, + isFastestScan: Bool, + scanInterval: TimeInterval + ) + { + self.isBlur = isBlur + self.isFastestScan = isFastestScan + self.scanInterval = scanInterval + } +} + +final class ImageProgressiveProvider: DataReceivingSideEffect { + + var onShouldApply: () -> Bool = { return true } + + func onDataReceived(_ session: URLSession, task: SessionDataTask, data: Data) { + + DispatchQueue.main.async { + guard self.onShouldApply() else { return } + self.update(data: task.mutableData, with: task.callbacks) + } + } + + private let option: ImageProgressive + private let refresh: (KFCrossPlatformImage) -> Void + + private let decoder: ImageProgressiveDecoder + private let queue = ImageProgressiveSerialQueue() + + init?(_ options: KingfisherParsedOptionsInfo, + refresh: @escaping (KFCrossPlatformImage) -> Void) { + guard let option = options.progressiveJPEG else { return nil } + + self.option = option + self.refresh = refresh + self.decoder = ImageProgressiveDecoder( + option, + processingQueue: options.processingQueue ?? sharedProcessingQueue, + creatingOptions: options.imageCreatingOptions + ) + } + + func update(data: Data, with callbacks: [SessionDataTask.TaskCallback]) { + guard !data.isEmpty else { return } + + queue.add(minimum: option.scanInterval) { completion in + + func decode(_ data: Data) { + self.decoder.decode(data, with: callbacks) { image in + defer { completion() } + guard self.onShouldApply() else { return } + guard let image = image else { return } + self.refresh(image) + } + } + + let semaphore = DispatchSemaphore(value: 0) + var onShouldApply: Bool = false + + CallbackQueue.mainAsync.execute { + onShouldApply = self.onShouldApply() + semaphore.signal() + } + semaphore.wait() + guard onShouldApply else { + self.queue.clean() + completion() + return + } + + if self.option.isFastestScan { + decode(self.decoder.scanning(data) ?? Data()) + } else { + self.decoder.scanning(data).forEach { decode($0) } + } + } + } +} + +private final class ImageProgressiveDecoder { + + private let option: ImageProgressive + private let processingQueue: CallbackQueue + private let creatingOptions: ImageCreatingOptions + private(set) var scannedCount = 0 + private(set) var scannedIndex = -1 + + init(_ option: ImageProgressive, + processingQueue: CallbackQueue, + creatingOptions: ImageCreatingOptions) { + self.option = option + self.processingQueue = processingQueue + self.creatingOptions = creatingOptions + } + + func scanning(_ data: Data) -> [Data] { + guard data.kf.contains(jpeg: .SOF2) else { + return [] + } + guard scannedIndex + 1 < data.count else { + return [] + } + + var datas: [Data] = [] + var index = scannedIndex + 1 + var count = scannedCount + + while index < data.count - 1 { + scannedIndex = index + // 0xFF, 0xDA - Start Of Scan + let SOS = ImageFormat.JPEGMarker.SOS.bytes + if data[index] == SOS[0], data[index + 1] == SOS[1] { + if count > 0 { + datas.append(data[0 ..< index]) + } + count += 1 + } + index += 1 + } + + // Found more scans this the previous time + guard count > scannedCount else { return [] } + scannedCount = count + + // `> 1` checks that we've received a first scan (SOS) and then received + // and also received a second scan (SOS). This way we know that we have + // at least one full scan available. + guard count > 1 else { return [] } + return datas + } + + func scanning(_ data: Data) -> Data? { + guard data.kf.contains(jpeg: .SOF2) else { + return nil + } + guard scannedIndex + 1 < data.count else { + return nil + } + + var index = scannedIndex + 1 + var count = scannedCount + var lastSOSIndex = 0 + + while index < data.count - 1 { + scannedIndex = index + // 0xFF, 0xDA - Start Of Scan + let SOS = ImageFormat.JPEGMarker.SOS.bytes + if data[index] == SOS[0], data[index + 1] == SOS[1] { + lastSOSIndex = index + count += 1 + } + index += 1 + } + + // Found more scans this the previous time + guard count > scannedCount else { return nil } + scannedCount = count + + // `> 1` checks that we've received a first scan (SOS) and then received + // and also received a second scan (SOS). This way we know that we have + // at least one full scan available. + guard count > 1 && lastSOSIndex > 0 else { return nil } + return data[0 ..< lastSOSIndex] + } + + func decode(_ data: Data, + with callbacks: [SessionDataTask.TaskCallback], + completion: @escaping (KFCrossPlatformImage?) -> Void) { + guard data.kf.contains(jpeg: .SOF2) else { + CallbackQueue.mainCurrentOrAsync.execute { completion(nil) } + return + } + + func processing(_ data: Data) { + let processor = ImageDataProcessor( + data: data, + callbacks: callbacks, + processingQueue: processingQueue + ) + processor.onImageProcessed.delegate(on: self) { (self, result) in + guard let image = try? result.0.get() else { + CallbackQueue.mainCurrentOrAsync.execute { completion(nil) } + return + } + + CallbackQueue.mainCurrentOrAsync.execute { completion(image) } + } + processor.process() + } + + // Blur partial images. + let count = scannedCount + + if option.isBlur, count < 6 { + processingQueue.execute { + // Progressively reduce blur as we load more scans. + let image = KingfisherWrapper.image( + data: data, + options: self.creatingOptions + ) + let radius = max(2, 14 - count * 4) + let temp = image?.kf.blurred(withRadius: CGFloat(radius)) + processing(temp?.kf.data(format: .JPEG) ?? data) + } + + } else { + processing(data) + } + } +} + +private final class ImageProgressiveSerialQueue { + typealias ClosureCallback = ((@escaping () -> Void)) -> Void + + private let queue: DispatchQueue + private var items: [DispatchWorkItem] = [] + private var notify: (() -> Void)? + private var lastTime: TimeInterval? + + init() { + self.queue = DispatchQueue(label: "com.onevcat.Kingfisher.ImageProgressive.SerialQueue") + } + + func add(minimum interval: TimeInterval, closure: @escaping ClosureCallback) { + let completion = { [weak self] in + guard let self = self else { return } + + self.queue.async { [weak self] in + guard let self = self else { return } + guard !self.items.isEmpty else { return } + + self.items.removeFirst() + + if let next = self.items.first { + self.queue.asyncAfter( + deadline: .now() + interval, + execute: next + ) + + } else { + self.lastTime = Date().timeIntervalSince1970 + self.notify?() + self.notify = nil + } + } + } + + queue.async { [weak self] in + guard let self = self else { return } + + let item = DispatchWorkItem { + closure(completion) + } + if self.items.isEmpty { + let difference = Date().timeIntervalSince1970 - (self.lastTime ?? 0) + let delay = difference < interval ? interval - difference : 0 + self.queue.asyncAfter(deadline: .now() + delay, execute: item) + } + self.items.append(item) + } + } + + func clean() { + queue.async { [weak self] in + guard let self = self else { return } + self.items.forEach { $0.cancel() } + self.items.removeAll() + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Image/ImageTransition.swift b/Demo/Pods/Kingfisher/Sources/Image/ImageTransition.swift new file mode 100644 index 0000000..4d042df --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/ImageTransition.swift @@ -0,0 +1,118 @@ +// +// ImageTransition.swift +// Kingfisher +// +// Created by Wei Wang on 15/9/18. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +#if os(iOS) || os(tvOS) +import UIKit + +/// Transition effect which will be used when an image downloaded and set by `UIImageView` +/// extension API in Kingfisher. You can assign an enum value with transition duration as +/// an item in `KingfisherOptionsInfo` to enable the animation transition. +/// +/// Apple's UIViewAnimationOptions is used under the hood. +/// For custom transition, you should specified your own transition options, animations and +/// completion handler as well. +/// +/// - none: No animation transition. +/// - fade: Fade in the loaded image in a given duration. +/// - flipFromLeft: Flip from left transition. +/// - flipFromRight: Flip from right transition. +/// - flipFromTop: Flip from top transition. +/// - flipFromBottom: Flip from bottom transition. +/// - custom: Custom transition. +public enum ImageTransition { + /// No animation transition. + case none + /// Fade in the loaded image in a given duration. + case fade(TimeInterval) + /// Flip from left transition. + case flipFromLeft(TimeInterval) + /// Flip from right transition. + case flipFromRight(TimeInterval) + /// Flip from top transition. + case flipFromTop(TimeInterval) + /// Flip from bottom transition. + case flipFromBottom(TimeInterval) + /// Custom transition defined by a general animation block. + /// - duration: The time duration of this custom transition. + /// - options: `UIView.AnimationOptions` should be used in the transition. + /// - animations: The animation block will be applied when setting image. + /// - completion: A block called when the transition animation finishes. + case custom(duration: TimeInterval, + options: UIView.AnimationOptions, + animations: ((UIImageView, UIImage) -> Void)?, + completion: ((Bool) -> Void)?) + + var duration: TimeInterval { + switch self { + case .none: return 0 + case .fade(let duration): return duration + + case .flipFromLeft(let duration): return duration + case .flipFromRight(let duration): return duration + case .flipFromTop(let duration): return duration + case .flipFromBottom(let duration): return duration + + case .custom(let duration, _, _, _): return duration + } + } + + var animationOptions: UIView.AnimationOptions { + switch self { + case .none: return [] + case .fade: return .transitionCrossDissolve + + case .flipFromLeft: return .transitionFlipFromLeft + case .flipFromRight: return .transitionFlipFromRight + case .flipFromTop: return .transitionFlipFromTop + case .flipFromBottom: return .transitionFlipFromBottom + + case .custom(_, let options, _, _): return options + } + } + + var animations: ((UIImageView, UIImage) -> Void)? { + switch self { + case .custom(_, _, let animations, _): return animations + default: return { $0.image = $1 } + } + } + + var completion: ((Bool) -> Void)? { + switch self { + case .custom(_, _, _, let completion): return completion + default: return nil + } + } +} +#else +// Just a placeholder for compiling on macOS. +public enum ImageTransition { + case none + /// This is a placeholder on macOS now. It is for SwiftUI (KFImage) to identify the fade option only. + case fade(TimeInterval) +} +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Image/Placeholder.swift b/Demo/Pods/Kingfisher/Sources/Image/Placeholder.swift new file mode 100644 index 0000000..94d9e3a --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Image/Placeholder.swift @@ -0,0 +1,82 @@ +// +// Placeholder.swift +// Kingfisher +// +// Created by Tieme van Veen on 28/08/2017. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if !os(watchOS) + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) +import AppKit +#endif + +#if canImport(UIKit) +import UIKit +#endif + +/// Represents a placeholder type which could be set while loading as well as +/// loading finished without getting an image. +public protocol Placeholder { + + /// How the placeholder should be added to a given image view. + func add(to imageView: KFCrossPlatformImageView) + + /// How the placeholder should be removed from a given image view. + func remove(from imageView: KFCrossPlatformImageView) +} + +/// Default implementation of an image placeholder. The image will be set or +/// reset directly for `image` property of the image view. +extension KFCrossPlatformImage: Placeholder { + /// How the placeholder should be added to a given image view. + public func add(to imageView: KFCrossPlatformImageView) { imageView.image = self } + + /// How the placeholder should be removed from a given image view. + public func remove(from imageView: KFCrossPlatformImageView) { imageView.image = nil } +} + +/// Default implementation of an arbitrary view as placeholder. The view will be +/// added as a subview when adding and be removed from its super view when removing. +/// +/// To use your customize View type as placeholder, simply let it conforming to +/// `Placeholder` by `extension MyView: Placeholder {}`. +extension Placeholder where Self: KFCrossPlatformView { + + /// How the placeholder should be added to a given image view. + public func add(to imageView: KFCrossPlatformImageView) { + imageView.addSubview(self) + translatesAutoresizingMaskIntoConstraints = false + + centerXAnchor.constraint(equalTo: imageView.centerXAnchor).isActive = true + centerYAnchor.constraint(equalTo: imageView.centerYAnchor).isActive = true + heightAnchor.constraint(equalTo: imageView.heightAnchor).isActive = true + widthAnchor.constraint(equalTo: imageView.widthAnchor).isActive = true + } + + /// How the placeholder should be removed from a given image view. + public func remove(from imageView: KFCrossPlatformImageView) { + removeFromSuperview() + } +} + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Networking/AuthenticationChallengeResponsable.swift b/Demo/Pods/Kingfisher/Sources/Networking/AuthenticationChallengeResponsable.swift new file mode 100644 index 0000000..d3b3ea1 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/AuthenticationChallengeResponsable.swift @@ -0,0 +1,94 @@ +// +// AuthenticationChallengeResponsable.swift +// Kingfisher +// +// Created by Wei Wang on 2018/10/11. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +@available(*, deprecated, message: "Typo. Use `AuthenticationChallengeResponsible` instead", renamed: "AuthenticationChallengeResponsible") +public typealias AuthenticationChallengeResponsable = AuthenticationChallengeResponsible + +/// Protocol indicates that an authentication challenge could be handled. +public protocol AuthenticationChallengeResponsible: AnyObject { + + /// Called when a session level authentication challenge is received. + /// This method provide a chance to handle and response to the authentication + /// challenge before downloading could start. + /// + /// - Parameters: + /// - downloader: The downloader which receives this challenge. + /// - challenge: An object that contains the request for authentication. + /// - completionHandler: A handler that your delegate method must call. + /// + /// - Note: This method is a forward from `URLSessionDelegate.urlSession(:didReceiveChallenge:completionHandler:)`. + /// Please refer to the document of it in `URLSessionDelegate`. + func downloader( + _ downloader: ImageDownloader, + didReceive challenge: URLAuthenticationChallenge, + completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) + + /// Called when a task level authentication challenge is received. + /// This method provide a chance to handle and response to the authentication + /// challenge before downloading could start. + /// + /// - Parameters: + /// - downloader: The downloader which receives this challenge. + /// - task: The task whose request requires authentication. + /// - challenge: An object that contains the request for authentication. + /// - completionHandler: A handler that your delegate method must call. + func downloader( + _ downloader: ImageDownloader, + task: URLSessionTask, + didReceive challenge: URLAuthenticationChallenge, + completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) +} + +extension AuthenticationChallengeResponsible { + + public func downloader( + _ downloader: ImageDownloader, + didReceive challenge: URLAuthenticationChallenge, + completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) + { + if challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust { + if let trustedHosts = downloader.trustedHosts, trustedHosts.contains(challenge.protectionSpace.host) { + let credential = URLCredential(trust: challenge.protectionSpace.serverTrust!) + completionHandler(.useCredential, credential) + return + } + } + + completionHandler(.performDefaultHandling, nil) + } + + public func downloader( + _ downloader: ImageDownloader, + task: URLSessionTask, + didReceive challenge: URLAuthenticationChallenge, + completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) + { + completionHandler(.performDefaultHandling, nil) + } + +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/ImageDataProcessor.swift b/Demo/Pods/Kingfisher/Sources/Networking/ImageDataProcessor.swift new file mode 100644 index 0000000..b368972 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/ImageDataProcessor.swift @@ -0,0 +1,74 @@ +// +// ImageDataProcessor.swift +// Kingfisher +// +// Created by Wei Wang on 2018/10/11. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +private let sharedProcessingQueue: CallbackQueue = + .dispatch(DispatchQueue(label: "com.onevcat.Kingfisher.ImageDownloader.Process")) + +// Handles image processing work on an own process queue. +class ImageDataProcessor { + let data: Data + let callbacks: [SessionDataTask.TaskCallback] + let queue: CallbackQueue + + // Note: We have an optimization choice there, to reduce queue dispatch by checking callback + // queue settings in each option... + let onImageProcessed = Delegate<(Result, SessionDataTask.TaskCallback), Void>() + + init(data: Data, callbacks: [SessionDataTask.TaskCallback], processingQueue: CallbackQueue?) { + self.data = data + self.callbacks = callbacks + self.queue = processingQueue ?? sharedProcessingQueue + } + + func process() { + queue.execute(doProcess) + } + + private func doProcess() { + var processedImages = [String: KFCrossPlatformImage]() + for callback in callbacks { + let processor = callback.options.processor + var image = processedImages[processor.identifier] + if image == nil { + image = processor.process(item: .data(data), options: callback.options) + processedImages[processor.identifier] = image + } + + let result: Result + if let image = image { + let finalImage = callback.options.backgroundDecode ? image.kf.decoded : image + result = .success(finalImage) + } else { + let error = KingfisherError.processorError( + reason: .processingFailed(processor: processor, item: .data(data))) + result = .failure(error) + } + onImageProcessed.call((result, callback)) + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/ImageDownloader.swift b/Demo/Pods/Kingfisher/Sources/Networking/ImageDownloader.swift new file mode 100644 index 0000000..2ab9a5f --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/ImageDownloader.swift @@ -0,0 +1,488 @@ +// +// ImageDownloader.swift +// Kingfisher +// +// Created by Wei Wang on 15/4/6. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if os(macOS) +import AppKit +#else +import UIKit +#endif + +typealias DownloadResult = Result + +/// Represents a success result of an image downloading progress. +public struct ImageLoadingResult { + + /// The downloaded image. + public let image: KFCrossPlatformImage + + /// Original URL of the image request. + public let url: URL? + + /// The raw data received from downloader. + public let originalData: Data +} + +/// Represents a task of an image downloading process. +public struct DownloadTask { + + /// The `SessionDataTask` object bounded to this download task. Multiple `DownloadTask`s could refer + /// to a same `sessionTask`. This is an optimization in Kingfisher to prevent multiple downloading task + /// for the same URL resource at the same time. + /// + /// When you `cancel` a `DownloadTask`, this `SessionDataTask` and its cancel token will be pass through. + /// You can use them to identify the cancelled task. + public let sessionTask: SessionDataTask + + /// The cancel token which is used to cancel the task. This is only for identify the task when it is cancelled. + /// To cancel a `DownloadTask`, use `cancel` instead. + public let cancelToken: SessionDataTask.CancelToken + + /// Cancel this task if it is running. It will do nothing if this task is not running. + /// + /// - Note: + /// In Kingfisher, there is an optimization to prevent starting another download task if the target URL is being + /// downloading. However, even when internally no new session task created, a `DownloadTask` will be still created + /// and returned when you call related methods, but it will share the session downloading task with a previous task. + /// In this case, if multiple `DownloadTask`s share a single session download task, cancelling a `DownloadTask` + /// does not affect other `DownloadTask`s. + /// + /// If you need to cancel all `DownloadTask`s of a url, use `ImageDownloader.cancel(url:)`. If you need to cancel + /// all downloading tasks of an `ImageDownloader`, use `ImageDownloader.cancelAll()`. + public func cancel() { + sessionTask.cancel(token: cancelToken) + } +} + +extension DownloadTask { + enum WrappedTask { + case download(DownloadTask) + case dataProviding + + func cancel() { + switch self { + case .download(let task): task.cancel() + case .dataProviding: break + } + } + + var value: DownloadTask? { + switch self { + case .download(let task): return task + case .dataProviding: return nil + } + } + } +} + +/// Represents a downloading manager for requesting the image with a URL from server. +open class ImageDownloader { + + // MARK: Singleton + /// The default downloader. + public static let `default` = ImageDownloader(name: "default") + + // MARK: Public Properties + /// The duration before the downloading is timeout. Default is 15 seconds. + open var downloadTimeout: TimeInterval = 15.0 + + /// A set of trusted hosts when receiving server trust challenges. A challenge with host name contained in this + /// set will be ignored. You can use this set to specify the self-signed site. It only will be used if you don't + /// specify the `authenticationChallengeResponder`. + /// + /// If `authenticationChallengeResponder` is set, this property will be ignored and the implementation of + /// `authenticationChallengeResponder` will be used instead. + open var trustedHosts: Set? + + /// Use this to set supply a configuration for the downloader. By default, + /// NSURLSessionConfiguration.ephemeralSessionConfiguration() will be used. + /// + /// You could change the configuration before a downloading task starts. + /// A configuration without persistent storage for caches is requested for downloader working correctly. + open var sessionConfiguration = URLSessionConfiguration.ephemeral { + didSet { + session.invalidateAndCancel() + session = URLSession(configuration: sessionConfiguration, delegate: sessionDelegate, delegateQueue: nil) + } + } + open var sessionDelegate: SessionDelegate { + didSet { + session.invalidateAndCancel() + session = URLSession(configuration: sessionConfiguration, delegate: sessionDelegate, delegateQueue: nil) + setupSessionHandler() + } + } + + /// Whether the download requests should use pipeline or not. Default is false. + open var requestsUsePipelining = false + + /// Delegate of this `ImageDownloader` object. See `ImageDownloaderDelegate` protocol for more. + open weak var delegate: ImageDownloaderDelegate? + + /// A responder for authentication challenge. + /// Downloader will forward the received authentication challenge for the downloading session to this responder. + open weak var authenticationChallengeResponder: AuthenticationChallengeResponsible? + + private let name: String + private var session: URLSession + + // MARK: Initializers + + /// Creates a downloader with name. + /// + /// - Parameter name: The name for the downloader. It should not be empty. + public init(name: String) { + if name.isEmpty { + fatalError("[Kingfisher] You should specify a name for the downloader. " + + "A downloader with empty name is not permitted.") + } + + self.name = name + + sessionDelegate = SessionDelegate() + session = URLSession( + configuration: sessionConfiguration, + delegate: sessionDelegate, + delegateQueue: nil) + + authenticationChallengeResponder = self + setupSessionHandler() + } + + deinit { session.invalidateAndCancel() } + + private func setupSessionHandler() { + sessionDelegate.onReceiveSessionChallenge.delegate(on: self) { (self, invoke) in + self.authenticationChallengeResponder?.downloader(self, didReceive: invoke.1, completionHandler: invoke.2) + } + sessionDelegate.onReceiveSessionTaskChallenge.delegate(on: self) { (self, invoke) in + self.authenticationChallengeResponder?.downloader( + self, task: invoke.1, didReceive: invoke.2, completionHandler: invoke.3) + } + sessionDelegate.onValidStatusCode.delegate(on: self) { (self, code) in + return (self.delegate ?? self).isValidStatusCode(code, for: self) + } + sessionDelegate.onDownloadingFinished.delegate(on: self) { (self, value) in + let (url, result) = value + do { + let value = try result.get() + self.delegate?.imageDownloader(self, didFinishDownloadingImageForURL: url, with: value, error: nil) + } catch { + self.delegate?.imageDownloader(self, didFinishDownloadingImageForURL: url, with: nil, error: error) + } + } + sessionDelegate.onDidDownloadData.delegate(on: self) { (self, task) in + return (self.delegate ?? self).imageDownloader(self, didDownload: task.mutableData, with: task) + } + } + + // Wraps `completionHandler` to `onCompleted` respectively. + private func createCompletionCallBack(_ completionHandler: ((DownloadResult) -> Void)?) -> Delegate? { + return completionHandler.map { block -> Delegate in + + let delegate = Delegate, Void>() + delegate.delegate(on: self) { (self, callback) in + block(callback) + } + return delegate + } + } + + private func createTaskCallback( + _ completionHandler: ((DownloadResult) -> Void)?, + options: KingfisherParsedOptionsInfo + ) -> SessionDataTask.TaskCallback + { + return SessionDataTask.TaskCallback( + onCompleted: createCompletionCallBack(completionHandler), + options: options + ) + } + + private func createDownloadContext( + with url: URL, + options: KingfisherParsedOptionsInfo, + done: @escaping ((Result) -> Void) + ) + { + func checkRequestAndDone(r: URLRequest) { + + // There is a possibility that request modifier changed the url to `nil` or empty. + // In this case, throw an error. + guard let url = r.url, !url.absoluteString.isEmpty else { + done(.failure(KingfisherError.requestError(reason: .invalidURL(request: r)))) + return + } + + done(.success(DownloadingContext(url: url, request: r, options: options))) + } + + // Creates default request. + var request = URLRequest(url: url, cachePolicy: .reloadIgnoringLocalCacheData, timeoutInterval: downloadTimeout) + request.httpShouldUsePipelining = requestsUsePipelining + if #available(macOS 10.15, iOS 13.0, watchOS 6.0, tvOS 13.0, *) , options.lowDataModeSource != nil { + request.allowsConstrainedNetworkAccess = false + } + + if let requestModifier = options.requestModifier { + // Modifies request before sending. + requestModifier.modified(for: request) { result in + guard let finalRequest = result else { + done(.failure(KingfisherError.requestError(reason: .emptyRequest))) + return + } + checkRequestAndDone(r: finalRequest) + } + } else { + checkRequestAndDone(r: request) + } + } + + private func addDownloadTask( + context: DownloadingContext, + callback: SessionDataTask.TaskCallback + ) -> DownloadTask + { + // Ready to start download. Add it to session task manager (`sessionHandler`) + let downloadTask: DownloadTask + if let existingTask = sessionDelegate.task(for: context.url) { + downloadTask = sessionDelegate.append(existingTask, callback: callback) + } else { + let sessionDataTask = session.dataTask(with: context.request) + sessionDataTask.priority = context.options.downloadPriority + downloadTask = sessionDelegate.add(sessionDataTask, url: context.url, callback: callback) + } + return downloadTask + } + + + private func reportWillDownloadImage(url: URL, request: URLRequest) { + delegate?.imageDownloader(self, willDownloadImageForURL: url, with: request) + } + + private func reportDidDownloadImageData(result: Result<(Data, URLResponse?), KingfisherError>, url: URL) { + var response: URLResponse? + var err: Error? + do { + response = try result.get().1 + } catch { + err = error + } + self.delegate?.imageDownloader( + self, + didFinishDownloadingImageForURL: url, + with: response, + error: err + ) + } + + private func reportDidProcessImage( + result: Result, url: URL, response: URLResponse? + ) + { + if let image = try? result.get() { + self.delegate?.imageDownloader(self, didDownload: image, for: url, with: response) + } + + } + + private func startDownloadTask( + context: DownloadingContext, + callback: SessionDataTask.TaskCallback + ) -> DownloadTask + { + + let downloadTask = addDownloadTask(context: context, callback: callback) + + let sessionTask = downloadTask.sessionTask + guard !sessionTask.started else { + return downloadTask + } + + sessionTask.onTaskDone.delegate(on: self) { (self, done) in + // Underlying downloading finishes. + // result: Result<(Data, URLResponse?)>, callbacks: [TaskCallback] + let (result, callbacks) = done + + // Before processing the downloaded data. + self.reportDidDownloadImageData(result: result, url: context.url) + + switch result { + // Download finished. Now process the data to an image. + case .success(let (data, response)): + let processor = ImageDataProcessor( + data: data, callbacks: callbacks, processingQueue: context.options.processingQueue + ) + processor.onImageProcessed.delegate(on: self) { (self, done) in + // `onImageProcessed` will be called for `callbacks.count` times, with each + // `SessionDataTask.TaskCallback` as the input parameter. + // result: Result, callback: SessionDataTask.TaskCallback + let (result, callback) = done + + self.reportDidProcessImage(result: result, url: context.url, response: response) + + let imageResult = result.map { ImageLoadingResult(image: $0, url: context.url, originalData: data) } + let queue = callback.options.callbackQueue + queue.execute { callback.onCompleted?.call(imageResult) } + } + processor.process() + + case .failure(let error): + callbacks.forEach { callback in + let queue = callback.options.callbackQueue + queue.execute { callback.onCompleted?.call(.failure(error)) } + } + } + } + + reportWillDownloadImage(url: context.url, request: context.request) + sessionTask.resume() + return downloadTask + } + + // MARK: Downloading Task + /// Downloads an image with a URL and option. Invoked internally by Kingfisher. Subclasses must invoke super. + /// + /// - Parameters: + /// - url: Target URL. + /// - options: The options could control download behavior. See `KingfisherOptionsInfo`. + /// - completionHandler: Called when the download progress finishes. This block will be called in the queue + /// defined in `.callbackQueue` in `options` parameter. + /// - Returns: A downloading task. You could call `cancel` on it to stop the download task. + @discardableResult + open func downloadImage( + with url: URL, + options: KingfisherParsedOptionsInfo, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var downloadTask: DownloadTask? + createDownloadContext(with: url, options: options) { result in + switch result { + case .success(let context): + // `downloadTask` will be set if the downloading started immediately. This is the case when no request + // modifier or a sync modifier (`ImageDownloadRequestModifier`) is used. Otherwise, when an + // `AsyncImageDownloadRequestModifier` is used the returned `downloadTask` of this method will be `nil` + // and the actual "delayed" task is given in `AsyncImageDownloadRequestModifier.onDownloadTaskStarted` + // callback. + downloadTask = self.startDownloadTask( + context: context, + callback: self.createTaskCallback(completionHandler, options: options) + ) + if let modifier = options.requestModifier { + modifier.onDownloadTaskStarted?(downloadTask) + } + case .failure(let error): + options.callbackQueue.execute { + completionHandler?(.failure(error)) + } + } + } + + return downloadTask + } + + /// Downloads an image with a URL and option. + /// + /// - Parameters: + /// - url: Target URL. + /// - options: The options could control download behavior. See `KingfisherOptionsInfo`. + /// - progressBlock: Called when the download progress updated. This block will be always be called in main queue. + /// - completionHandler: Called when the download progress finishes. This block will be called in the queue + /// defined in `.callbackQueue` in `options` parameter. + /// - Returns: A downloading task. You could call `cancel` on it to stop the download task. + @discardableResult + open func downloadImage( + with url: URL, + options: KingfisherOptionsInfo? = nil, + progressBlock: DownloadProgressBlock? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + var info = KingfisherParsedOptionsInfo(options) + if let block = progressBlock { + info.onDataReceived = (info.onDataReceived ?? []) + [ImageLoadingProgressSideEffect(block)] + } + return downloadImage( + with: url, + options: info, + completionHandler: completionHandler) + } + + /// Downloads an image with a URL and option. + /// + /// - Parameters: + /// - url: Target URL. + /// - options: The options could control download behavior. See `KingfisherOptionsInfo`. + /// - completionHandler: Called when the download progress finishes. This block will be called in the queue + /// defined in `.callbackQueue` in `options` parameter. + /// - Returns: A downloading task. You could call `cancel` on it to stop the download task. + @discardableResult + open func downloadImage( + with url: URL, + options: KingfisherOptionsInfo? = nil, + completionHandler: ((Result) -> Void)? = nil) -> DownloadTask? + { + downloadImage( + with: url, + options: KingfisherParsedOptionsInfo(options), + completionHandler: completionHandler + ) + } +} + +// MARK: Cancelling Task +extension ImageDownloader { + + /// Cancel all downloading tasks for this `ImageDownloader`. It will trigger the completion handlers + /// for all not-yet-finished downloading tasks. + /// + /// If you need to only cancel a certain task, call `cancel()` on the `DownloadTask` + /// returned by the downloading methods. If you need to cancel all `DownloadTask`s of a certain url, + /// use `ImageDownloader.cancel(url:)`. + public func cancelAll() { + sessionDelegate.cancelAll() + } + + /// Cancel all downloading tasks for a given URL. It will trigger the completion handlers for + /// all not-yet-finished downloading tasks for the URL. + /// + /// - Parameter url: The URL which you want to cancel downloading. + public func cancel(url: URL) { + sessionDelegate.cancel(url: url) + } +} + +// Use the default implementation from extension of `AuthenticationChallengeResponsible`. +extension ImageDownloader: AuthenticationChallengeResponsible {} + +// Use the default implementation from extension of `ImageDownloaderDelegate`. +extension ImageDownloader: ImageDownloaderDelegate {} + +extension ImageDownloader { + struct DownloadingContext { + let url: URL + let request: URLRequest + let options: KingfisherParsedOptionsInfo + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/ImageDownloaderDelegate.swift b/Demo/Pods/Kingfisher/Sources/Networking/ImageDownloaderDelegate.swift new file mode 100644 index 0000000..7f98640 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/ImageDownloaderDelegate.swift @@ -0,0 +1,154 @@ +// +// ImageDownloaderDelegate.swift +// Kingfisher +// +// Created by Wei Wang on 2018/10/11. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Protocol of `ImageDownloader`. This protocol provides a set of methods which are related to image downloader +/// working stages and rules. +public protocol ImageDownloaderDelegate: AnyObject { + + /// Called when the `ImageDownloader` object will start downloading an image from a specified URL. + /// + /// - Parameters: + /// - downloader: The `ImageDownloader` object which is used for the downloading operation. + /// - url: URL of the starting request. + /// - request: The request object for the download process. + /// + func imageDownloader(_ downloader: ImageDownloader, willDownloadImageForURL url: URL, with request: URLRequest?) + + /// Called when the `ImageDownloader` completes a downloading request with success or failure. + /// + /// - Parameters: + /// - downloader: The `ImageDownloader` object which is used for the downloading operation. + /// - url: URL of the original request URL. + /// - response: The response object of the downloading process. + /// - error: The error in case of failure. + /// + func imageDownloader( + _ downloader: ImageDownloader, + didFinishDownloadingImageForURL url: URL, + with response: URLResponse?, + error: Error?) + + /// Called when the `ImageDownloader` object successfully downloaded image data from specified URL. This is + /// your last chance to verify or modify the downloaded data before Kingfisher tries to perform addition + /// processing on the image data. + /// + /// - Parameters: + /// - downloader: The `ImageDownloader` object which is used for the downloading operation. + /// - data: The original downloaded data. + /// - dataTask: The data task contains request and response information of the download. + /// - Note: + /// This can be used to pre-process raw image data before creation of `Image` instance (i.e. + /// decrypting or verification). If `nil` returned, the processing is interrupted and a `KingfisherError` with + /// `ResponseErrorReason.dataModifyingFailed` will be raised. You could use this fact to stop the image + /// processing flow if you find the data is corrupted or malformed. + /// + /// If this method is implemented, `imageDownloader(_:didDownload:for:)` will not be called anymore. + func imageDownloader(_ downloader: ImageDownloader, didDownload data: Data, with dataTask: SessionDataTask) -> Data? + + /// Called when the `ImageDownloader` object successfully downloaded image data from specified URL. This is + /// your last chance to verify or modify the downloaded data before Kingfisher tries to perform addition + /// processing on the image data. + /// + /// - Parameters: + /// - downloader: The `ImageDownloader` object which is used for the downloading operation. + /// - data: The original downloaded data. + /// - url: The URL of the original request URL. + /// - Returns: The data from which Kingfisher should use to create an image. You need to provide valid data + /// which content is one of the supported image file format. Kingfisher will perform process on this + /// data and try to convert it to an image object. + /// - Note: + /// This can be used to pre-process raw image data before creation of `Image` instance (i.e. + /// decrypting or verification). If `nil` returned, the processing is interrupted and a `KingfisherError` with + /// `ResponseErrorReason.dataModifyingFailed` will be raised. You could use this fact to stop the image + /// processing flow if you find the data is corrupted or malformed. + /// + /// If `imageDownloader(_:didDownload:with:)` is implemented, this method will not be called anymore. + func imageDownloader(_ downloader: ImageDownloader, didDownload data: Data, for url: URL) -> Data? + + /// Called when the `ImageDownloader` object successfully downloads and processes an image from specified URL. + /// + /// - Parameters: + /// - downloader: The `ImageDownloader` object which is used for the downloading operation. + /// - image: The downloaded and processed image. + /// - url: URL of the original request URL. + /// - response: The original response object of the downloading process. + /// + func imageDownloader( + _ downloader: ImageDownloader, + didDownload image: KFCrossPlatformImage, + for url: URL, + with response: URLResponse?) + + /// Checks if a received HTTP status code is valid or not. + /// By default, a status code in range 200..<400 is considered as valid. + /// If an invalid code is received, the downloader will raise an `KingfisherError` with + /// `ResponseErrorReason.invalidHTTPStatusCode` as its reason. + /// + /// - Parameters: + /// - code: The received HTTP status code. + /// - downloader: The `ImageDownloader` object asks for validate status code. + /// - Returns: Returns a value to indicate whether this HTTP status code is valid or not. + /// - Note: If the default 200 to 400 valid code does not suit your need, + /// you can implement this method to change that behavior. + func isValidStatusCode(_ code: Int, for downloader: ImageDownloader) -> Bool +} + +// Default implementation for `ImageDownloaderDelegate`. +extension ImageDownloaderDelegate { + public func imageDownloader( + _ downloader: ImageDownloader, + willDownloadImageForURL url: URL, + with request: URLRequest?) {} + + public func imageDownloader( + _ downloader: ImageDownloader, + didFinishDownloadingImageForURL url: URL, + with response: URLResponse?, + error: Error?) {} + + public func imageDownloader( + _ downloader: ImageDownloader, + didDownload image: KFCrossPlatformImage, + for url: URL, + with response: URLResponse?) {} + + public func isValidStatusCode(_ code: Int, for downloader: ImageDownloader) -> Bool { + return (200..<400).contains(code) + } + + public func imageDownloader(_ downloader: ImageDownloader, didDownload data: Data, with task: SessionDataTask) -> Data? { + guard let url = task.originalURL else { + return data + } + return imageDownloader(downloader, didDownload: data, for: url) + } + + public func imageDownloader(_ downloader: ImageDownloader, didDownload data: Data, for url: URL) -> Data? { + return data + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/ImageModifier.swift b/Demo/Pods/Kingfisher/Sources/Networking/ImageModifier.swift new file mode 100644 index 0000000..0acd0e8 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/ImageModifier.swift @@ -0,0 +1,116 @@ +// +// ImageModifier.swift +// Kingfisher +// +// Created by Ethan Gill on 2017/11/28. +// +// Copyright (c) 2019 Ethan Gill +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// An `ImageModifier` can be used to change properties on an image between cache serialization and the actual use of +/// the image. The `modify(_:)` method will be called after the image retrieved from its source and before it returned +/// to the caller. This modified image is expected to be only used for rendering purpose, any changes applied by the +/// `ImageModifier` will not be serialized or cached. +public protocol ImageModifier { + /// Modify an input `Image`. + /// + /// - parameter image: Image which will be modified by `self` + /// + /// - returns: The modified image. + /// + /// - Note: The return value will be unmodified if modifying is not possible on + /// the current platform. + /// - Note: Most modifiers support UIImage or NSImage, but not CGImage. + func modify(_ image: KFCrossPlatformImage) -> KFCrossPlatformImage +} + +/// A wrapper for creating an `ImageModifier` easier. +/// This type conforms to `ImageModifier` and wraps an image modify block. +/// If the `block` throws an error, the original image will be used. +public struct AnyImageModifier: ImageModifier { + + /// A block which modifies images, or returns the original image + /// if modification cannot be performed with an error. + let block: (KFCrossPlatformImage) throws -> KFCrossPlatformImage + + /// Creates an `AnyImageModifier` with a given `modify` block. + public init(modify: @escaping (KFCrossPlatformImage) throws -> KFCrossPlatformImage) { + block = modify + } + + /// Modify an input `Image`. See `ImageModifier` protocol for more. + public func modify(_ image: KFCrossPlatformImage) -> KFCrossPlatformImage { + return (try? block(image)) ?? image + } +} + +#if os(iOS) || os(tvOS) || os(watchOS) +import UIKit + +/// Modifier for setting the rendering mode of images. +public struct RenderingModeImageModifier: ImageModifier { + + /// The rendering mode to apply to the image. + public let renderingMode: UIImage.RenderingMode + + /// Creates a `RenderingModeImageModifier`. + /// + /// - Parameter renderingMode: The rendering mode to apply to the image. Default is `.automatic`. + public init(renderingMode: UIImage.RenderingMode = .automatic) { + self.renderingMode = renderingMode + } + + /// Modify an input `Image`. See `ImageModifier` protocol for more. + public func modify(_ image: KFCrossPlatformImage) -> KFCrossPlatformImage { + return image.withRenderingMode(renderingMode) + } +} + +/// Modifier for setting the `flipsForRightToLeftLayoutDirection` property of images. +public struct FlipsForRightToLeftLayoutDirectionImageModifier: ImageModifier { + + /// Creates a `FlipsForRightToLeftLayoutDirectionImageModifier`. + public init() {} + + /// Modify an input `Image`. See `ImageModifier` protocol for more. + public func modify(_ image: KFCrossPlatformImage) -> KFCrossPlatformImage { + return image.imageFlippedForRightToLeftLayoutDirection() + } +} + +/// Modifier for setting the `alignmentRectInsets` property of images. +public struct AlignmentRectInsetsImageModifier: ImageModifier { + + /// The alignment insets to apply to the image + public let alignmentInsets: UIEdgeInsets + + /// Creates an `AlignmentRectInsetsImageModifier`. + public init(alignmentInsets: UIEdgeInsets) { + self.alignmentInsets = alignmentInsets + } + + /// Modify an input `Image`. See `ImageModifier` protocol for more. + public func modify(_ image: KFCrossPlatformImage) -> KFCrossPlatformImage { + return image.withAlignmentRectInsets(alignmentInsets) + } +} +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Networking/ImagePrefetcher.swift b/Demo/Pods/Kingfisher/Sources/Networking/ImagePrefetcher.swift new file mode 100644 index 0000000..3fce14c --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/ImagePrefetcher.swift @@ -0,0 +1,442 @@ +// +// ImagePrefetcher.swift +// Kingfisher +// +// Created by Claire Knight on 24/02/2016 +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + + +#if os(macOS) +import AppKit +#else +import UIKit +#endif + +/// Progress update block of prefetcher when initialized with a list of resources. +/// +/// - `skippedResources`: An array of resources that are already cached before the prefetching starting. +/// - `failedResources`: An array of resources that fail to be downloaded. It could because of being cancelled while +/// downloading, encountered an error when downloading or the download not being started at all. +/// - `completedResources`: An array of resources that are downloaded and cached successfully. +public typealias PrefetcherProgressBlock = + ((_ skippedResources: [Resource], _ failedResources: [Resource], _ completedResources: [Resource]) -> Void) + +/// Progress update block of prefetcher when initialized with a list of resources. +/// +/// - `skippedSources`: An array of sources that are already cached before the prefetching starting. +/// - `failedSources`: An array of sources that fail to be fetched. +/// - `completedResources`: An array of sources that are fetched and cached successfully. +public typealias PrefetcherSourceProgressBlock = + ((_ skippedSources: [Source], _ failedSources: [Source], _ completedSources: [Source]) -> Void) + +/// Completion block of prefetcher when initialized with a list of sources. +/// +/// - `skippedResources`: An array of resources that are already cached before the prefetching starting. +/// - `failedResources`: An array of resources that fail to be downloaded. It could because of being cancelled while +/// downloading, encountered an error when downloading or the download not being started at all. +/// - `completedResources`: An array of resources that are downloaded and cached successfully. +public typealias PrefetcherCompletionHandler = + ((_ skippedResources: [Resource], _ failedResources: [Resource], _ completedResources: [Resource]) -> Void) + +/// Completion block of prefetcher when initialized with a list of sources. +/// +/// - `skippedSources`: An array of sources that are already cached before the prefetching starting. +/// - `failedSources`: An array of sources that fail to be fetched. +/// - `completedSources`: An array of sources that are fetched and cached successfully. +public typealias PrefetcherSourceCompletionHandler = + ((_ skippedSources: [Source], _ failedSources: [Source], _ completedSources: [Source]) -> Void) + +/// `ImagePrefetcher` represents a downloading manager for requesting many images via URLs, then caching them. +/// This is useful when you know a list of image resources and want to download them before showing. It also works with +/// some Cocoa prefetching mechanism like table view or collection view `prefetchDataSource`, to start image downloading +/// and caching before they display on screen. +public class ImagePrefetcher: CustomStringConvertible { + + public var description: String { + return "\(Unmanaged.passUnretained(self).toOpaque())" + } + + /// The maximum concurrent downloads to use when prefetching images. Default is 5. + public var maxConcurrentDownloads = 5 + + private let prefetchSources: [Source] + private let optionsInfo: KingfisherParsedOptionsInfo + + private var progressBlock: PrefetcherProgressBlock? + private var completionHandler: PrefetcherCompletionHandler? + + private var progressSourceBlock: PrefetcherSourceProgressBlock? + private var completionSourceHandler: PrefetcherSourceCompletionHandler? + + private var tasks = [String: DownloadTask.WrappedTask]() + + private var pendingSources: ArraySlice + private var skippedSources = [Source]() + private var completedSources = [Source]() + private var failedSources = [Source]() + + private var stopped = false + + // A manager used for prefetching. We will use the helper methods in manager. + private let manager: KingfisherManager + + private let pretchQueue = DispatchQueue(label: "com.onevcat.Kingfisher.ImagePrefetcher.pretchQueue") + private static let requestingQueue = DispatchQueue(label: "com.onevcat.Kingfisher.ImagePrefetcher.requestingQueue") + + private var finished: Bool { + let totalFinished: Int = failedSources.count + skippedSources.count + completedSources.count + return totalFinished == prefetchSources.count && tasks.isEmpty + } + + /// Creates an image prefetcher with an array of URLs. + /// + /// The prefetcher should be initiated with a list of prefetching targets. The URLs list is immutable. + /// After you get a valid `ImagePrefetcher` object, you call `start()` on it to begin the prefetching process. + /// The images which are already cached will be skipped without downloading again. + /// + /// - Parameters: + /// - urls: The URLs which should be prefetched. + /// - options: Options could control some behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called every time an resource is downloaded, skipped or cancelled. + /// - completionHandler: Called when the whole prefetching process finished. + /// + /// - Note: + /// By default, the `ImageDownloader.defaultDownloader` and `ImageCache.defaultCache` will be used as + /// the downloader and cache target respectively. You can specify another downloader or cache by using + /// a customized `KingfisherOptionsInfo`. Both the progress and completion block will be invoked in + /// main thread. The `.callbackQueue` value in `optionsInfo` will be ignored in this method. + public convenience init( + urls: [URL], + options: KingfisherOptionsInfo? = nil, + progressBlock: PrefetcherProgressBlock? = nil, + completionHandler: PrefetcherCompletionHandler? = nil) + { + let resources: [Resource] = urls.map { $0 } + self.init( + resources: resources, + options: options, + progressBlock: progressBlock, + completionHandler: completionHandler) + } + + /// Creates an image prefetcher with an array of URLs. + /// + /// The prefetcher should be initiated with a list of prefetching targets. The URLs list is immutable. + /// After you get a valid `ImagePrefetcher` object, you call `start()` on it to begin the prefetching process. + /// The images which are already cached will be skipped without downloading again. + /// + /// - Parameters: + /// - urls: The URLs which should be prefetched. + /// - options: Options could control some behaviors. See `KingfisherOptionsInfo` for more. + /// - completionHandler: Called when the whole prefetching process finished. + /// + /// - Note: + /// By default, the `ImageDownloader.defaultDownloader` and `ImageCache.defaultCache` will be used as + /// the downloader and cache target respectively. You can specify another downloader or cache by using + /// a customized `KingfisherOptionsInfo`. Both the progress and completion block will be invoked in + /// main thread. The `.callbackQueue` value in `optionsInfo` will be ignored in this method. + public convenience init( + urls: [URL], + options: KingfisherOptionsInfo? = nil, + completionHandler: PrefetcherCompletionHandler? = nil) + { + let resources: [Resource] = urls.map { $0 } + self.init( + resources: resources, + options: options, + progressBlock: nil, + completionHandler: completionHandler) + } + + /// Creates an image prefetcher with an array of resources. + /// + /// - Parameters: + /// - resources: The resources which should be prefetched. See `Resource` type for more. + /// - options: Options could control some behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called every time an resource is downloaded, skipped or cancelled. + /// - completionHandler: Called when the whole prefetching process finished. + /// + /// - Note: + /// By default, the `ImageDownloader.defaultDownloader` and `ImageCache.defaultCache` will be used as + /// the downloader and cache target respectively. You can specify another downloader or cache by using + /// a customized `KingfisherOptionsInfo`. Both the progress and completion block will be invoked in + /// main thread. The `.callbackQueue` value in `optionsInfo` will be ignored in this method. + public convenience init( + resources: [Resource], + options: KingfisherOptionsInfo? = nil, + progressBlock: PrefetcherProgressBlock? = nil, + completionHandler: PrefetcherCompletionHandler? = nil) + { + self.init(sources: resources.map { $0.convertToSource() }, options: options) + self.progressBlock = progressBlock + self.completionHandler = completionHandler + } + + /// Creates an image prefetcher with an array of resources. + /// + /// - Parameters: + /// - resources: The resources which should be prefetched. See `Resource` type for more. + /// - options: Options could control some behaviors. See `KingfisherOptionsInfo` for more. + /// - completionHandler: Called when the whole prefetching process finished. + /// + /// - Note: + /// By default, the `ImageDownloader.defaultDownloader` and `ImageCache.defaultCache` will be used as + /// the downloader and cache target respectively. You can specify another downloader or cache by using + /// a customized `KingfisherOptionsInfo`. Both the progress and completion block will be invoked in + /// main thread. The `.callbackQueue` value in `optionsInfo` will be ignored in this method. + public convenience init( + resources: [Resource], + options: KingfisherOptionsInfo? = nil, + completionHandler: PrefetcherCompletionHandler? = nil) + { + self.init(sources: resources.map { $0.convertToSource() }, options: options) + self.completionHandler = completionHandler + } + + /// Creates an image prefetcher with an array of sources. + /// + /// - Parameters: + /// - sources: The sources which should be prefetched. See `Source` type for more. + /// - options: Options could control some behaviors. See `KingfisherOptionsInfo` for more. + /// - progressBlock: Called every time an source fetching successes, fails, is skipped. + /// - completionHandler: Called when the whole prefetching process finished. + /// + /// - Note: + /// By default, the `ImageDownloader.defaultDownloader` and `ImageCache.defaultCache` will be used as + /// the downloader and cache target respectively. You can specify another downloader or cache by using + /// a customized `KingfisherOptionsInfo`. Both the progress and completion block will be invoked in + /// main thread. The `.callbackQueue` value in `optionsInfo` will be ignored in this method. + public convenience init(sources: [Source], + options: KingfisherOptionsInfo? = nil, + progressBlock: PrefetcherSourceProgressBlock? = nil, + completionHandler: PrefetcherSourceCompletionHandler? = nil) + { + self.init(sources: sources, options: options) + self.progressSourceBlock = progressBlock + self.completionSourceHandler = completionHandler + } + + /// Creates an image prefetcher with an array of sources. + /// + /// - Parameters: + /// - sources: The sources which should be prefetched. See `Source` type for more. + /// - options: Options could control some behaviors. See `KingfisherOptionsInfo` for more. + /// - completionHandler: Called when the whole prefetching process finished. + /// + /// - Note: + /// By default, the `ImageDownloader.defaultDownloader` and `ImageCache.defaultCache` will be used as + /// the downloader and cache target respectively. You can specify another downloader or cache by using + /// a customized `KingfisherOptionsInfo`. Both the progress and completion block will be invoked in + /// main thread. The `.callbackQueue` value in `optionsInfo` will be ignored in this method. + public convenience init(sources: [Source], + options: KingfisherOptionsInfo? = nil, + completionHandler: PrefetcherSourceCompletionHandler? = nil) + { + self.init(sources: sources, options: options) + self.completionSourceHandler = completionHandler + } + + init(sources: [Source], options: KingfisherOptionsInfo?) { + var options = KingfisherParsedOptionsInfo(options) + prefetchSources = sources + pendingSources = ArraySlice(sources) + + // We want all callbacks from our prefetch queue, so we should ignore the callback queue in options. + // Add our own callback dispatch queue to make sure all internal callbacks are + // coming back in our expected queue. + options.callbackQueue = .dispatch(pretchQueue) + optionsInfo = options + + let cache = optionsInfo.targetCache ?? .default + let downloader = optionsInfo.downloader ?? .default + manager = KingfisherManager(downloader: downloader, cache: cache) + } + + /// Starts to download the resources and cache them. This can be useful for background downloading + /// of assets that are required for later use in an app. This code will not try and update any UI + /// with the results of the process. + public func start() { + pretchQueue.async { + guard !self.stopped else { + assertionFailure("You can not restart the same prefetcher. Try to create a new prefetcher.") + self.handleComplete() + return + } + + guard self.maxConcurrentDownloads > 0 else { + assertionFailure("There should be concurrent downloads value should be at least 1.") + self.handleComplete() + return + } + + // Empty case. + guard self.prefetchSources.count > 0 else { + self.handleComplete() + return + } + + let initialConcurrentDownloads = min(self.prefetchSources.count, self.maxConcurrentDownloads) + for _ in 0 ..< initialConcurrentDownloads { + if let resource = self.pendingSources.popFirst() { + self.startPrefetching(resource) + } + } + } + } + + /// Stops current downloading progress, and cancel any future prefetching activity that might be occuring. + public func stop() { + pretchQueue.async { + if self.finished { return } + self.stopped = true + self.tasks.values.forEach { $0.cancel() } + } + } + + private func downloadAndCache(_ source: Source) { + + let downloadTaskCompletionHandler: ((Result) -> Void) = { result in + self.tasks.removeValue(forKey: source.cacheKey) + do { + let _ = try result.get() + self.completedSources.append(source) + } catch { + self.failedSources.append(source) + } + + self.reportProgress() + if self.stopped { + if self.tasks.isEmpty { + self.failedSources.append(contentsOf: self.pendingSources) + self.handleComplete() + } + } else { + self.reportCompletionOrStartNext() + } + } + + var downloadTask: DownloadTask.WrappedTask? + ImagePrefetcher.requestingQueue.sync { + let context = RetrievingContext( + options: optionsInfo, originalSource: source + ) + downloadTask = manager.loadAndCacheImage( + source: source, + context: context, + completionHandler: downloadTaskCompletionHandler) + } + + if let downloadTask = downloadTask { + tasks[source.cacheKey] = downloadTask + } + } + + private func append(cached source: Source) { + skippedSources.append(source) + + reportProgress() + reportCompletionOrStartNext() + } + + private func startPrefetching(_ source: Source) + { + if optionsInfo.forceRefresh { + downloadAndCache(source) + return + } + + let cacheType = manager.cache.imageCachedType( + forKey: source.cacheKey, + processorIdentifier: optionsInfo.processor.identifier) + switch cacheType { + case .memory: + append(cached: source) + case .disk: + if optionsInfo.alsoPrefetchToMemory { + let context = RetrievingContext(options: optionsInfo, originalSource: source) + _ = manager.retrieveImageFromCache( + source: source, + context: context) + { + _ in + self.append(cached: source) + } + } else { + append(cached: source) + } + case .none: + downloadAndCache(source) + } + } + + private func reportProgress() { + + if progressBlock == nil && progressSourceBlock == nil { + return + } + + let skipped = self.skippedSources + let failed = self.failedSources + let completed = self.completedSources + CallbackQueue.mainCurrentOrAsync.execute { + self.progressSourceBlock?(skipped, failed, completed) + self.progressBlock?( + skipped.compactMap { $0.asResource }, + failed.compactMap { $0.asResource }, + completed.compactMap { $0.asResource } + ) + } + } + + private func reportCompletionOrStartNext() { + if let resource = self.pendingSources.popFirst() { + // Loose call stack for huge ammount of sources. + pretchQueue.async { self.startPrefetching(resource) } + } else { + guard allFinished else { return } + self.handleComplete() + } + } + + var allFinished: Bool { + return skippedSources.count + failedSources.count + completedSources.count == prefetchSources.count + } + + private func handleComplete() { + + if completionHandler == nil && completionSourceHandler == nil { + return + } + + // The completion handler should be called on the main thread + CallbackQueue.mainCurrentOrAsync.execute { + self.completionSourceHandler?(self.skippedSources, self.failedSources, self.completedSources) + self.completionHandler?( + self.skippedSources.compactMap { $0.asResource }, + self.failedSources.compactMap { $0.asResource }, + self.completedSources.compactMap { $0.asResource } + ) + self.completionHandler = nil + self.progressBlock = nil + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/RedirectHandler.swift b/Demo/Pods/Kingfisher/Sources/Networking/RedirectHandler.swift new file mode 100644 index 0000000..0d13cbe --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/RedirectHandler.swift @@ -0,0 +1,76 @@ +// +// RedirectHandler.swift +// Kingfisher +// +// Created by Roman Maidanovych on 2018/12/10. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents and wraps a method for modifying request during an image download request redirection. +public protocol ImageDownloadRedirectHandler { + + /// The `ImageDownloadRedirectHandler` contained will be used to change the request before redirection. + /// This is the posibility you can modify the image download request during redirection. You can modify the + /// request for some customizing purpose, such as adding auth token to the header, do basic HTTP auth or + /// something like url mapping. + /// + /// Usually, you pass an `ImageDownloadRedirectHandler` as the associated value of + /// `KingfisherOptionsInfoItem.redirectHandler` and use it as the `options` parameter in related methods. + /// + /// If you do nothing with the input `request` and return it as is, a downloading process will redirect with it. + /// + /// - Parameters: + /// - task: The current `SessionDataTask` which triggers this redirect. + /// - response: The response received during redirection. + /// - newRequest: The request for redirection which can be modified. + /// - completionHandler: A closure for being called with modified request. + func handleHTTPRedirection( + for task: SessionDataTask, + response: HTTPURLResponse, + newRequest: URLRequest, + completionHandler: @escaping (URLRequest?) -> Void) +} + +/// A wrapper for creating an `ImageDownloadRedirectHandler` easier. +/// This type conforms to `ImageDownloadRedirectHandler` and wraps a redirect request modify block. +public struct AnyRedirectHandler: ImageDownloadRedirectHandler { + + let block: (SessionDataTask, HTTPURLResponse, URLRequest, @escaping (URLRequest?) -> Void) -> Void + + public func handleHTTPRedirection( + for task: SessionDataTask, + response: HTTPURLResponse, + newRequest: URLRequest, + completionHandler: @escaping (URLRequest?) -> Void) + { + block(task, response, newRequest, completionHandler) + } + + /// Creates a value of `ImageDownloadRedirectHandler` which runs `modify` block. + /// + /// - Parameter modify: The request modifying block runs when a request modifying task comes. + /// + public init(handle: @escaping (SessionDataTask, HTTPURLResponse, URLRequest, @escaping (URLRequest?) -> Void) -> Void) { + block = handle + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/RequestModifier.swift b/Demo/Pods/Kingfisher/Sources/Networking/RequestModifier.swift new file mode 100644 index 0000000..a1d972d --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/RequestModifier.swift @@ -0,0 +1,108 @@ +// +// RequestModifier.swift +// Kingfisher +// +// Created by Wei Wang on 2016/09/05. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents and wraps a method for modifying request before an image download request starts in an asynchronous way. +public protocol AsyncImageDownloadRequestModifier { + + /// This method will be called just before the `request` being sent. + /// This is the last chance you can modify the image download request. You can modify the request for some + /// customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url mapping. + /// When you have done with the modification, call the `reportModified` block with the modified request and the data + /// download will happen with this request. + /// + /// Usually, you pass an `AsyncImageDownloadRequestModifier` as the associated value of + /// `KingfisherOptionsInfoItem.requestModifier` and use it as the `options` parameter in related methods. + /// + /// If you do nothing with the input `request` and return it as is, a downloading process will start with it. + /// + /// - Parameters: + /// - request: The input request contains necessary information like `url`. This request is generated + /// according to your resource url as a GET request. + /// - reportModified: The callback block you need to call after the asynchronous modifying done. + /// + func modified(for request: URLRequest, reportModified: @escaping (URLRequest?) -> Void) + + /// A block will be called when the download task started. + /// + /// If an `AsyncImageDownloadRequestModifier` and the asynchronous modification happens before the download, the + /// related download method will not return a valid `DownloadTask` value. Instead, you can get one from this method. + var onDownloadTaskStarted: ((DownloadTask?) -> Void)? { get } +} + +/// Represents and wraps a method for modifying request before an image download request starts. +public protocol ImageDownloadRequestModifier: AsyncImageDownloadRequestModifier { + + /// This method will be called just before the `request` being sent. + /// This is the last chance you can modify the image download request. You can modify the request for some + /// customizing purpose, such as adding auth token to the header, do basic HTTP auth or something like url mapping. + /// + /// Usually, you pass an `ImageDownloadRequestModifier` as the associated value of + /// `KingfisherOptionsInfoItem.requestModifier` and use it as the `options` parameter in related methods. + /// + /// If you do nothing with the input `request` and return it as is, a downloading process will start with it. + /// + /// - Parameter request: The input request contains necessary information like `url`. This request is generated + /// according to your resource url as a GET request. + /// - Returns: A modified version of request, which you wish to use for downloading an image. If `nil` returned, + /// a `KingfisherError.requestError` with `.emptyRequest` as its reason will occur. + /// + func modified(for request: URLRequest) -> URLRequest? +} + +extension ImageDownloadRequestModifier { + public func modified(for request: URLRequest, reportModified: @escaping (URLRequest?) -> Void) { + let request = modified(for: request) + reportModified(request) + } + + /// This is `nil` for a sync `ImageDownloadRequestModifier` by default. You can get the `DownloadTask` from the + /// return value of downloader method. + public var onDownloadTaskStarted: ((DownloadTask?) -> Void)? { return nil } +} + +/// A wrapper for creating an `ImageDownloadRequestModifier` easier. +/// This type conforms to `ImageDownloadRequestModifier` and wraps an image modify block. +public struct AnyModifier: ImageDownloadRequestModifier { + + let block: (URLRequest) -> URLRequest? + + /// For `ImageDownloadRequestModifier` conformation. + public func modified(for request: URLRequest) -> URLRequest? { + return block(request) + } + + /// Creates a value of `ImageDownloadRequestModifier` which runs `modify` block. + /// + /// - Parameter modify: The request modifying block runs when a request modifying task comes. + /// The return `URLRequest?` value of this block will be used as the image download request. + /// If `nil` returned, a `KingfisherError.requestError` with `.emptyRequest` as its + /// reason will occur. + public init(modify: @escaping (URLRequest) -> URLRequest?) { + block = modify + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/RetryStrategy.swift b/Demo/Pods/Kingfisher/Sources/Networking/RetryStrategy.swift new file mode 100644 index 0000000..1ab5a2e --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/RetryStrategy.swift @@ -0,0 +1,153 @@ +// +// RetryStrategy.swift +// Kingfisher +// +// Created by onevcat on 2020/05/04. +// +// Copyright (c) 2020 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents a retry context which could be used to determine the current retry status. +public class RetryContext { + + /// The source from which the target image should be retrieved. + public let source: Source + + /// The last error which caused current retry behavior. + public let error: KingfisherError + + /// The retried count before current retry happens. This value is `0` if the current retry is for the first time. + public var retriedCount: Int + + /// A user set value for passing any other information during the retry. If you choose to use `RetryDecision.retry` + /// as the retry decision for `RetryStrategy.retry(context:retryHandler:)`, the associated value of + /// `RetryDecision.retry` will be delivered to you in the next retry. + public internal(set) var userInfo: Any? = nil + + init(source: Source, error: KingfisherError) { + self.source = source + self.error = error + self.retriedCount = 0 + } + + @discardableResult + func increaseRetryCount() -> RetryContext { + retriedCount += 1 + return self + } +} + +/// Represents decision of behavior on the current retry. +public enum RetryDecision { + /// A retry should happen. The associated `userInfo` will be pass to the next retry in the `RetryContext` parameter. + case retry(userInfo: Any?) + /// There should be no more retry attempt. The image retrieving process will fail with an error. + case stop +} + +/// Defines a retry strategy can be applied to a `.retryStrategy` option. +public protocol RetryStrategy { + + /// Kingfisher calls this method if an error happens during the image retrieving process from a `KingfisherManager`. + /// You implement this method to provide necessary logic based on the `context` parameter. Then you need to call + /// `retryHandler` to pass the retry decision back to Kingfisher. + /// + /// - Parameters: + /// - context: The retry context containing information of current retry attempt. + /// - retryHandler: A block you need to call with a decision of whether the retry should happen or not. + func retry(context: RetryContext, retryHandler: @escaping (RetryDecision) -> Void) +} + +/// A retry strategy that guides Kingfisher to retry when a `.responseError` happens, with a specified max retry count +/// and a certain interval mechanism. +public struct DelayRetryStrategy: RetryStrategy { + + /// Represents the interval mechanism which used in a `DelayRetryStrategy`. + public enum Interval { + /// The next retry attempt should happen in fixed seconds. For example, if the associated value is 3, the + /// attempts happens after 3 seconds after the previous decision is made. + case seconds(TimeInterval) + /// The next retry attempt should happen in an accumulated duration. For example, if the associated value is 3, + /// the attempts happens with interval of 3, 6, 9, 12, ... seconds. + case accumulated(TimeInterval) + /// Uses a block to determine the next interval. The current retry count is given as a parameter. + case custom(block: (_ retriedCount: Int) -> TimeInterval) + + func timeInterval(for retriedCount: Int) -> TimeInterval { + let retryAfter: TimeInterval + switch self { + case .seconds(let interval): + retryAfter = interval + case .accumulated(let interval): + retryAfter = Double(retriedCount + 1) * interval + case .custom(let block): + retryAfter = block(retriedCount) + } + return retryAfter + } + } + + /// The max retry count defined for the retry strategy + public let maxRetryCount: Int + + /// The retry interval mechanism defined for the retry strategy. + public let retryInterval: Interval + + /// Creates a delay retry strategy. + /// - Parameters: + /// - maxRetryCount: The max retry count. + /// - retryInterval: The retry interval mechanism. By default, `.seconds(3)` is used to provide a constant retry + /// interval. + public init(maxRetryCount: Int, retryInterval: Interval = .seconds(3)) { + self.maxRetryCount = maxRetryCount + self.retryInterval = retryInterval + } + + public func retry(context: RetryContext, retryHandler: @escaping (RetryDecision) -> Void) { + // Retry count exceeded. + guard context.retriedCount < maxRetryCount else { + retryHandler(.stop) + return + } + + // User cancel the task. No retry. + guard !context.error.isTaskCancelled else { + retryHandler(.stop) + return + } + + // Only retry for a response error. + guard case KingfisherError.responseError = context.error else { + retryHandler(.stop) + return + } + + let interval = retryInterval.timeInterval(for: context.retriedCount) + if interval == 0 { + retryHandler(.retry(userInfo: nil)) + } else { + DispatchQueue.main.asyncAfter(deadline: .now() + interval) { + retryHandler(.retry(userInfo: nil)) + } + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/SessionDataTask.swift b/Demo/Pods/Kingfisher/Sources/Networking/SessionDataTask.swift new file mode 100644 index 0000000..8932bd5 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/SessionDataTask.swift @@ -0,0 +1,127 @@ +// +// SessionDataTask.swift +// Kingfisher +// +// Created by Wei Wang on 2018/11/1. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +/// Represents a session data task in `ImageDownloader`. It consists of an underlying `URLSessionDataTask` and +/// an array of `TaskCallback`. Multiple `TaskCallback`s could be added for a single downloading data task. +public class SessionDataTask { + + /// Represents the type of token which used for cancelling a task. + public typealias CancelToken = Int + + struct TaskCallback { + let onCompleted: Delegate, Void>? + let options: KingfisherParsedOptionsInfo + } + + /// Downloaded raw data of current task. + public private(set) var mutableData: Data + + // This is a copy of `task.originalRequest?.url`. It is for getting a race-safe behavior for a pitfall on iOS 13. + // Ref: https://github.com/onevcat/Kingfisher/issues/1511 + public let originalURL: URL? + + /// The underlying download task. It is only for debugging purpose when you encountered an error. You should not + /// modify the content of this task or start it yourself. + public let task: URLSessionDataTask + private var callbacksStore = [CancelToken: TaskCallback]() + + var callbacks: [SessionDataTask.TaskCallback] { + lock.lock() + defer { lock.unlock() } + return Array(callbacksStore.values) + } + + private var currentToken = 0 + private let lock = NSLock() + + let onTaskDone = Delegate<(Result<(Data, URLResponse?), KingfisherError>, [TaskCallback]), Void>() + let onCallbackCancelled = Delegate<(CancelToken, TaskCallback), Void>() + + var started = false + var containsCallbacks: Bool { + // We should be able to use `task.state != .running` to check it. + // However, in some rare cases, cancelling the task does not change + // task state to `.cancelling` immediately, but still in `.running`. + // So we need to check callbacks count to for sure that it is safe to remove the + // task in delegate. + return !callbacks.isEmpty + } + + init(task: URLSessionDataTask) { + self.task = task + self.originalURL = task.originalRequest?.url + mutableData = Data() + } + + func addCallback(_ callback: TaskCallback) -> CancelToken { + lock.lock() + defer { lock.unlock() } + callbacksStore[currentToken] = callback + defer { currentToken += 1 } + return currentToken + } + + func removeCallback(_ token: CancelToken) -> TaskCallback? { + lock.lock() + defer { lock.unlock() } + if let callback = callbacksStore[token] { + callbacksStore[token] = nil + return callback + } + return nil + } + + func removeAllCallbacks() -> Void { + lock.lock() + defer { lock.unlock() } + callbacksStore.removeAll() + } + + func resume() { + guard !started else { return } + started = true + task.resume() + } + + func cancel(token: CancelToken) { + guard let callback = removeCallback(token) else { + return + } + onCallbackCancelled.call((token, callback)) + } + + func forceCancel() { + for token in callbacksStore.keys { + cancel(token: token) + } + } + + func didReceiveData(_ data: Data) { + mutableData.append(data) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Networking/SessionDelegate.swift b/Demo/Pods/Kingfisher/Sources/Networking/SessionDelegate.swift new file mode 100644 index 0000000..d2582ff --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Networking/SessionDelegate.swift @@ -0,0 +1,262 @@ +// +// SessionDelegate.swift +// Kingfisher +// +// Created by Wei Wang on 2018/11/1. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +// Represents the delegate object of downloader session. It also behave like a task manager for downloading. +@objc(KFSessionDelegate) // Fix for ObjC header name conflicting. https://github.com/onevcat/Kingfisher/issues/1530 +open class SessionDelegate: NSObject { + + typealias SessionChallengeFunc = ( + URLSession, + URLAuthenticationChallenge, + (URLSession.AuthChallengeDisposition, URLCredential?) -> Void + ) + + typealias SessionTaskChallengeFunc = ( + URLSession, + URLSessionTask, + URLAuthenticationChallenge, + (URLSession.AuthChallengeDisposition, URLCredential?) -> Void + ) + + private var tasks: [URL: SessionDataTask] = [:] + private let lock = NSLock() + + let onValidStatusCode = Delegate() + let onDownloadingFinished = Delegate<(URL, Result), Void>() + let onDidDownloadData = Delegate() + + let onReceiveSessionChallenge = Delegate() + let onReceiveSessionTaskChallenge = Delegate() + + func add( + _ dataTask: URLSessionDataTask, + url: URL, + callback: SessionDataTask.TaskCallback) -> DownloadTask + { + lock.lock() + defer { lock.unlock() } + + // Create a new task if necessary. + let task = SessionDataTask(task: dataTask) + task.onCallbackCancelled.delegate(on: self) { [weak task] (self, value) in + guard let task = task else { return } + + let (token, callback) = value + + let error = KingfisherError.requestError(reason: .taskCancelled(task: task, token: token)) + task.onTaskDone.call((.failure(error), [callback])) + // No other callbacks waiting, we can clear the task now. + if !task.containsCallbacks { + let dataTask = task.task + + self.cancelTask(dataTask) + self.remove(task) + } + } + let token = task.addCallback(callback) + tasks[url] = task + return DownloadTask(sessionTask: task, cancelToken: token) + } + + private func cancelTask(_ dataTask: URLSessionDataTask) { + lock.lock() + defer { lock.unlock() } + dataTask.cancel() + } + + func append( + _ task: SessionDataTask, + callback: SessionDataTask.TaskCallback) -> DownloadTask + { + let token = task.addCallback(callback) + return DownloadTask(sessionTask: task, cancelToken: token) + } + + private func remove(_ task: SessionDataTask) { + lock.lock() + defer { lock.unlock() } + + guard let url = task.originalURL else { + return + } + task.removeAllCallbacks() + tasks[url] = nil + } + + private func task(for task: URLSessionTask) -> SessionDataTask? { + lock.lock() + defer { lock.unlock() } + + guard let url = task.originalRequest?.url else { + return nil + } + guard let sessionTask = tasks[url] else { + return nil + } + guard sessionTask.task.taskIdentifier == task.taskIdentifier else { + return nil + } + return sessionTask + } + + func task(for url: URL) -> SessionDataTask? { + lock.lock() + defer { lock.unlock() } + return tasks[url] + } + + func cancelAll() { + lock.lock() + let taskValues = tasks.values + lock.unlock() + for task in taskValues { + task.forceCancel() + } + } + + func cancel(url: URL) { + lock.lock() + let task = tasks[url] + lock.unlock() + task?.forceCancel() + } +} + +extension SessionDelegate: URLSessionDataDelegate { + + open func urlSession( + _ session: URLSession, + dataTask: URLSessionDataTask, + didReceive response: URLResponse, + completionHandler: @escaping (URLSession.ResponseDisposition) -> Void) + { + guard let httpResponse = response as? HTTPURLResponse else { + let error = KingfisherError.responseError(reason: .invalidURLResponse(response: response)) + onCompleted(task: dataTask, result: .failure(error)) + completionHandler(.cancel) + return + } + + let httpStatusCode = httpResponse.statusCode + guard onValidStatusCode.call(httpStatusCode) == true else { + let error = KingfisherError.responseError(reason: .invalidHTTPStatusCode(response: httpResponse)) + onCompleted(task: dataTask, result: .failure(error)) + completionHandler(.cancel) + return + } + completionHandler(.allow) + } + + open func urlSession(_ session: URLSession, dataTask: URLSessionDataTask, didReceive data: Data) { + guard let task = self.task(for: dataTask) else { + return + } + + task.didReceiveData(data) + + task.callbacks.forEach { callback in + callback.options.onDataReceived?.forEach { sideEffect in + sideEffect.onDataReceived(session, task: task, data: data) + } + } + } + + open func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) { + guard let sessionTask = self.task(for: task) else { return } + + if let url = sessionTask.originalURL { + let result: Result + if let error = error { + result = .failure(KingfisherError.responseError(reason: .URLSessionError(error: error))) + } else if let response = task.response { + result = .success(response) + } else { + result = .failure(KingfisherError.responseError(reason: .noURLResponse(task: sessionTask))) + } + onDownloadingFinished.call((url, result)) + } + + let result: Result<(Data, URLResponse?), KingfisherError> + if let error = error { + result = .failure(KingfisherError.responseError(reason: .URLSessionError(error: error))) + } else { + if let data = onDidDownloadData.call(sessionTask) { + result = .success((data, task.response)) + } else { + result = .failure(KingfisherError.responseError(reason: .dataModifyingFailed(task: sessionTask))) + } + } + onCompleted(task: task, result: result) + } + + open func urlSession( + _ session: URLSession, + didReceive challenge: URLAuthenticationChallenge, + completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) + { + onReceiveSessionChallenge.call((session, challenge, completionHandler)) + } + + open func urlSession( + _ session: URLSession, + task: URLSessionTask, + didReceive challenge: URLAuthenticationChallenge, + completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) + { + onReceiveSessionTaskChallenge.call((session, task, challenge, completionHandler)) + } + + open func urlSession( + _ session: URLSession, + task: URLSessionTask, + willPerformHTTPRedirection response: HTTPURLResponse, + newRequest request: URLRequest, + completionHandler: @escaping (URLRequest?) -> Void) + { + guard let sessionDataTask = self.task(for: task), + let redirectHandler = Array(sessionDataTask.callbacks).last?.options.redirectHandler else + { + completionHandler(request) + return + } + + redirectHandler.handleHTTPRedirection( + for: sessionDataTask, + response: response, + newRequest: request, + completionHandler: completionHandler) + } + + private func onCompleted(task: URLSessionTask, result: Result<(Data, URLResponse?), KingfisherError>) { + guard let sessionTask = self.task(for: task) else { + return + } + sessionTask.onTaskDone.call((result, sessionTask.callbacks)) + remove(sessionTask) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/SwiftUI/ImageBinder.swift b/Demo/Pods/Kingfisher/Sources/SwiftUI/ImageBinder.swift new file mode 100644 index 0000000..6114479 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/SwiftUI/ImageBinder.swift @@ -0,0 +1,149 @@ +// +// ImageBinder.swift +// Kingfisher +// +// Created by onevcat on 2019/06/27. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(SwiftUI) && canImport(Combine) +import SwiftUI +import Combine + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImage { + + /// Represents a binder for `KFImage`. It takes responsibility as an `ObjectBinding` and performs + /// image downloading and progress reporting based on `KingfisherManager`. + class ImageBinder: ObservableObject { + + init() {} + + var downloadTask: DownloadTask? + private var loading = false + + var loadingOrSucceeded: Bool { + return loading || loadedImage != nil + } + + // Do not use @Published due to https://github.com/onevcat/Kingfisher/issues/1717. Revert to @Published once + // we can drop iOS 12. + private(set) var loaded = false + + private(set) var animating = false + + var loadedImage: KFCrossPlatformImage? = nil { willSet { objectWillChange.send() } } + var progress: Progress = .init() + + func markLoading() { + loading = true + } + + func markLoaded(sendChangeEvent: Bool) { + loaded = true + if sendChangeEvent { + objectWillChange.send() + } + } + + func start(context: Context) { + guard let source = context.source else { + CallbackQueue.mainCurrentOrAsync.execute { + context.onFailureDelegate.call(KingfisherError.imageSettingError(reason: .emptySource)) + if let image = context.options.onFailureImage { + self.loadedImage = image + } + self.loading = false + self.markLoaded(sendChangeEvent: false) + } + return + } + + loading = true + + progress = .init() + downloadTask = KingfisherManager.shared + .retrieveImage( + with: source, + options: context.options, + progressBlock: { size, total in + self.updateProgress(downloaded: size, total: total) + context.onProgressDelegate.call((size, total)) + }, + completionHandler: { [weak self] result in + + guard let self = self else { return } + + CallbackQueue.mainCurrentOrAsync.execute { + self.downloadTask = nil + self.loading = false + } + + switch result { + case .success(let value): + CallbackQueue.mainCurrentOrAsync.execute { + if let fadeDuration = context.fadeTransitionDuration(cacheType: value.cacheType) { + self.animating = true + let animation = Animation.linear(duration: fadeDuration) + withAnimation(animation) { + // Trigger the view render to apply the animation. + self.markLoaded(sendChangeEvent: true) + } + } else { + self.markLoaded(sendChangeEvent: false) + } + self.loadedImage = value.image + self.animating = false + } + + CallbackQueue.mainAsync.execute { + context.onSuccessDelegate.call(value) + } + case .failure(let error): + CallbackQueue.mainCurrentOrAsync.execute { + if let image = context.options.onFailureImage { + self.loadedImage = image + } + self.markLoaded(sendChangeEvent: true) + } + + CallbackQueue.mainAsync.execute { + context.onFailureDelegate.call(error) + } + } + }) + } + + private func updateProgress(downloaded: Int64, total: Int64) { + progress.totalUnitCount = total + progress.completedUnitCount = downloaded + objectWillChange.send() + } + + /// Cancels the download task if it is in progress. + func cancel() { + downloadTask?.cancel() + downloadTask = nil + loading = false + } + } +} +#endif diff --git a/Demo/Pods/Kingfisher/Sources/SwiftUI/ImageContext.swift b/Demo/Pods/Kingfisher/Sources/SwiftUI/ImageContext.swift new file mode 100644 index 0000000..730477b --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/SwiftUI/ImageContext.swift @@ -0,0 +1,102 @@ +// +// ImageContext.swift +// Kingfisher +// +// Created by onevcat on 2021/05/08. +// +// Copyright (c) 2021 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(SwiftUI) && canImport(Combine) +import SwiftUI +import Combine + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImage { + public class Context { + let source: Source? + var options = KingfisherParsedOptionsInfo( + KingfisherManager.shared.defaultOptions + [.loadDiskFileSynchronously] + ) + + var configurations: [(HoldingView) -> HoldingView] = [] + var renderConfigurations: [(HoldingView.RenderingView) -> Void] = [] + var contentConfiguration: ((HoldingView) -> AnyView)? = nil + + var cancelOnDisappear: Bool = false + var placeholder: ((Progress) -> AnyView)? = nil + + let onFailureDelegate = Delegate() + let onSuccessDelegate = Delegate() + let onProgressDelegate = Delegate<(Int64, Int64), Void>() + + var startLoadingBeforeViewAppear: Bool = false + + init(source: Source?) { + self.source = source + } + + func shouldApplyFade(cacheType: CacheType) -> Bool { + options.forceTransition || cacheType == .none + } + + func fadeTransitionDuration(cacheType: CacheType) -> TimeInterval? { + shouldApplyFade(cacheType: cacheType) + ? options.transition.fadeDuration + : nil + } + } +} + +extension ImageTransition { + // Only for fade effect in SwiftUI. + fileprivate var fadeDuration: TimeInterval? { + switch self { + case .fade(let duration): + return duration + default: + return nil + } + } +} + + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImage.Context: Hashable { + public static func == (lhs: KFImage.Context, rhs: KFImage.Context) -> Bool { + lhs.source == rhs.source && + lhs.options.processor.identifier == rhs.options.processor.identifier + } + + public func hash(into hasher: inout Hasher) { + hasher.combine(source) + hasher.combine(options.processor.identifier) + } +} + +#if canImport(UIKit) && !os(watchOS) +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFAnimatedImage { + public typealias Context = KFImage.Context + typealias ImageBinder = KFImage.ImageBinder +} +#endif + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/SwiftUI/KFAnimatedImage.swift b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFAnimatedImage.swift new file mode 100644 index 0000000..ad25eb2 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFAnimatedImage.swift @@ -0,0 +1,96 @@ +// +// KFAnimatedImage.swift +// Kingfisher +// +// Created by wangxingbin on 2021/4/29. +// +// Copyright (c) 2021 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(SwiftUI) && canImport(Combine) && canImport(UIKit) && !os(watchOS) +import SwiftUI +import Combine + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +public struct KFAnimatedImage: KFImageProtocol { + public typealias HoldingView = KFAnimatedImageViewRepresenter + public var context: Context + public init(context: KFImage.Context) { + self.context = context + } + + /// Configures current rendering view with a `block`. This block will be applied when the under-hood + /// `AnimatedImageView` is created in `UIViewRepresentable.makeUIView(context:)` + /// + /// - Parameter block: The block applies to the animated image view. + /// - Returns: A `KFAnimatedImage` view that being configured by the `block`. + public func configure(_ block: @escaping (HoldingView.RenderingView) -> Void) -> Self { + context.renderConfigurations.append(block) + return self + } +} + +/// A wrapped `UIViewRepresentable` of `AnimatedImageView` +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +public struct KFAnimatedImageViewRepresenter: UIViewRepresentable, KFImageHoldingView { + public typealias RenderingView = AnimatedImageView + public static func created(from image: KFCrossPlatformImage?, context: KFImage.Context) -> KFAnimatedImageViewRepresenter { + KFAnimatedImageViewRepresenter(image: image, context: context) + } + + var image: KFCrossPlatformImage? + let context: KFImage.Context + + public func makeUIView(context: Context) -> AnimatedImageView { + let view = AnimatedImageView() + + self.context.renderConfigurations.forEach { $0(view) } + + view.image = image + + // Allow SwiftUI scale (fit/fill) working fine. + view.setContentCompressionResistancePriority(.defaultLow, for: .horizontal) + view.setContentCompressionResistancePriority(.defaultLow, for: .vertical) + return view + } + + public func updateUIView(_ uiView: AnimatedImageView, context: Context) { + uiView.image = image + } +} + +#if DEBUG +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +struct KFAnimatedImage_Previews: PreviewProvider { + static var previews: some View { + Group { + KFAnimatedImage(source: .network(URL(string: "https://raw.githubusercontent.com/onevcat/Kingfisher-TestImages/master/DemoAppImage/GIF/1.gif")!)) + .onSuccess { r in + print(r) + } + .placeholder { + ProgressView() + } + .padding() + } + } +} +#endif +#endif diff --git a/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImage.swift b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImage.swift new file mode 100644 index 0000000..67f1c19 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImage.swift @@ -0,0 +1,106 @@ +// +// KFImage.swift +// Kingfisher +// +// Created by onevcat on 2019/06/26. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(SwiftUI) && canImport(Combine) +import SwiftUI +import Combine + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +public struct KFImage: KFImageProtocol { + public var context: Context + public init(context: Context) { + self.context = context + } +} + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension Image: KFImageHoldingView { + public typealias RenderingView = Image + public static func created(from image: KFCrossPlatformImage?, context: KFImage.Context) -> Image { + Image(crossPlatformImage: image) + } +} + +// MARK: - Image compatibility. +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImage { + + public func resizable( + capInsets: EdgeInsets = EdgeInsets(), + resizingMode: Image.ResizingMode = .stretch) -> KFImage + { + configure { $0.resizable(capInsets: capInsets, resizingMode: resizingMode) } + } + + public func renderingMode(_ renderingMode: Image.TemplateRenderingMode?) -> KFImage { + configure { $0.renderingMode(renderingMode) } + } + + public func interpolation(_ interpolation: Image.Interpolation) -> KFImage { + configure { $0.interpolation(interpolation) } + } + + public func antialiased(_ isAntialiased: Bool) -> KFImage { + configure { $0.antialiased(isAntialiased) } + } + + /// Starts the loading process of `self` immediately. + /// + /// By default, a `KFImage` will not load its source until the `onAppear` is called. This is a lazily loading + /// behavior and provides better performance. However, when you refresh the view, the lazy loading also causes a + /// flickering since the loading does not happen immediately. Call this method if you want to start the load at once + /// could help avoiding the flickering, with some performance trade-off. + /// + /// - Deprecated: This is not necessary anymore since `@StateObject` is used for holding the image data. + /// It does nothing now and please just remove it. + /// + /// - Returns: The `Self` value with changes applied. + @available(*, deprecated, message: "This is not necessary anymore since `@StateObject` is used. It does nothing now and please just remove it.") + public func loadImmediately(_ start: Bool = true) -> KFImage { + return self + } +} + +#if DEBUG +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +struct KFImage_Previews: PreviewProvider { + static var previews: some View { + Group { + KFImage.url(URL(string: "https://raw.githubusercontent.com/onevcat/Kingfisher/master/images/logo.png")!) + .onSuccess { r in + print(r) + } + .placeholder { p in + ProgressView(p) + } + .resizable() + .aspectRatio(contentMode: .fit) + .padding() + } + } +} +#endif +#endif diff --git a/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageOptions.swift b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageOptions.swift new file mode 100644 index 0000000..a63d909 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageOptions.swift @@ -0,0 +1,158 @@ +// +// KFImageOptions.swift +// Kingfisher +// +// Created by onevcat on 2020/12/20. +// +// Copyright (c) 2020 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(SwiftUI) && canImport(Combine) +import SwiftUI +import Combine + +// MARK: - KFImage creating. +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImageProtocol { + + /// Creates a `KFImage` for a given `Source`. + /// - Parameters: + /// - source: The `Source` object defines data information from network or a data provider. + /// - Returns: A `KFImage` for future configuration or embedding to a `SwiftUI.View`. + public static func source( + _ source: Source? + ) -> Self + { + Self.init(source: source) + } + + /// Creates a `KFImage` for a given `Resource`. + /// - Parameters: + /// - source: The `Resource` object defines data information like key or URL. + /// - Returns: A `KFImage` for future configuration or embedding to a `SwiftUI.View`. + public static func resource( + _ resource: Resource? + ) -> Self + { + source(resource?.convertToSource()) + } + + /// Creates a `KFImage` for a given `URL`. + /// - Parameters: + /// - url: The URL where the image should be downloaded. + /// - cacheKey: The key used to store the downloaded image in cache. + /// If `nil`, the `absoluteString` of `url` is used as the cache key. + /// - Returns: A `KFImage` for future configuration or embedding to a `SwiftUI.View`. + public static func url( + _ url: URL?, cacheKey: String? = nil + ) -> Self + { + source(url?.convertToSource(overrideCacheKey: cacheKey)) + } + + /// Creates a `KFImage` for a given `ImageDataProvider`. + /// - Parameters: + /// - provider: The `ImageDataProvider` object contains information about the data. + /// - Returns: A `KFImage` for future configuration or embedding to a `SwiftUI.View`. + public static func dataProvider( + _ provider: ImageDataProvider? + ) -> Self + { + source(provider?.convertToSource()) + } + + /// Creates a builder for some given raw data and a cache key. + /// - Parameters: + /// - data: The data object from which the image should be created. + /// - cacheKey: The key used to store the downloaded image in cache. + /// - Returns: A `KFImage` for future configuration or embedding to a `SwiftUI.View`. + public static func data( + _ data: Data?, cacheKey: String + ) -> Self + { + if let data = data { + return dataProvider(RawImageDataProvider(data: data, cacheKey: cacheKey)) + } else { + return dataProvider(nil) + } + } +} + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImageProtocol { + /// Sets a placeholder `View` which shows when loading the image, with a progress parameter as input. + /// - Parameter content: A view that describes the placeholder. + /// - Returns: A `KFImage` view that contains `content` as its placeholder. + public func placeholder(@ViewBuilder _ content: @escaping (Progress) -> P) -> Self { + context.placeholder = { progress in + return AnyView(content(progress)) + } + return self + } + + /// Sets a placeholder `View` which shows when loading the image. + /// - Parameter content: A view that describes the placeholder. + /// - Returns: A `KFImage` view that contains `content` as its placeholder. + public func placeholder(@ViewBuilder _ content: @escaping () -> P) -> Self { + placeholder { _ in content() } + } + + /// Sets cancelling the download task bound to `self` when the view disappearing. + /// - Parameter flag: Whether cancel the task or not. + /// - Returns: A `KFImage` view that cancels downloading task when disappears. + public func cancelOnDisappear(_ flag: Bool) -> Self { + context.cancelOnDisappear = flag + return self + } + + /// Sets a fade transition for the image task. + /// - Parameter duration: The duration of the fade transition. + /// - Returns: A `KFImage` with changes applied. + /// + /// Kingfisher will use the fade transition to animate the image in if it is downloaded from web. + /// The transition will not happen when the + /// image is retrieved from either memory or disk cache by default. If you need to do the transition even when + /// the image being retrieved from cache, also call `forceRefresh()` on the returned `KFImage`. + public func fade(duration: TimeInterval) -> Self { + context.options.transition = .fade(duration) + return self + } + + /// Sets whether to start the image loading before the view actually appears. + /// + /// By default, Kingfisher performs a lazy loading for `KFImage`. The image loading won't start until the view's + /// `onAppear` is called. However, sometimes you may want to trigger an aggressive loading for the view. By enabling + /// this, the `KFImage` will try to load the view when its `body` is evaluated when the image loading is not yet + /// started or a previous loading did fail. + /// + /// - Parameter flag: Whether the image loading should happen before view appear. Default is `true`. + /// - Returns: A `KFImage` with changes applied. + /// + /// - Note: This is a temporary workaround for an issue from iOS 16, where the SwiftUI view's `onAppear` is not + /// called when it is deeply embedded inside a `List` or `ForEach`. + /// See [#1988](https://github.com/onevcat/Kingfisher/issues/1988). It may cause performance regression, especially + /// if you have a lot of images to load in the view. Use it as your own risk. + /// + public func startLoadingBeforeViewAppear(_ flag: Bool = true) -> Self { + context.startLoadingBeforeViewAppear = flag + return self + } +} +#endif diff --git a/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageProtocol.swift b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageProtocol.swift new file mode 100644 index 0000000..5a5ad4b --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageProtocol.swift @@ -0,0 +1,112 @@ +// +// KFImageProtocol.swift +// Kingfisher +// +// Created by onevcat on 2021/05/08. +// +// Copyright (c) 2021 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(SwiftUI) && canImport(Combine) +import SwiftUI +import Combine + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +public protocol KFImageProtocol: View, KFOptionSetter { + associatedtype HoldingView: KFImageHoldingView + var context: KFImage.Context { get set } + init(context: KFImage.Context) +} + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImageProtocol { + public var body: some View { + ZStack { + KFImageRenderer( + context: context + ).id(context) + } + } + + /// Creates a Kingfisher compatible image view to load image from the given `Source`. + /// - Parameters: + /// - source: The image `Source` defining where to load the target image. + public init(source: Source?) { + let context = KFImage.Context(source: source) + self.init(context: context) + } + + /// Creates a Kingfisher compatible image view to load image from the given `URL`. + /// - Parameters: + /// - source: The image `Source` defining where to load the target image. + public init(_ url: URL?) { + self.init(source: url?.convertToSource()) + } + + /// Configures current image with a `block` and return another `Image` to use as the final content. + /// + /// This block will be lazily applied when creating the final `Image`. + /// + /// If multiple `configure` modifiers are added to the image, they will be evaluated by order. If you want to + /// configure the input image (which is usually an `Image` value) to a non-`Image` value, use `contentConfigure`. + /// + /// - Parameter block: The block applies to loaded image. The block should return an `Image` that is configured. + /// - Returns: A `KFImage` view that configures internal `Image` with `block`. + public func configure(_ block: @escaping (HoldingView) -> HoldingView) -> Self { + context.configurations.append(block) + return self + } + + /// Configures current image with a `block` and return a `View` to use as the final content. + /// + /// This block will be lazily applied when creating the final `Image`. + /// + /// If multiple `contentConfigure` modifiers are added to the image, only the last one will be stored and used. + /// + /// - Parameter block: The block applies to the loaded image. The block should return a `View` that is configured. + /// - Returns: A `KFImage` view that configures internal `Image` with `block`. + public func contentConfigure(_ block: @escaping (HoldingView) -> V) -> Self { + context.contentConfiguration = { AnyView(block($0)) } + return self + } +} + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +public protocol KFImageHoldingView: View { + associatedtype RenderingView + static func created(from image: KFCrossPlatformImage?, context: KFImage.Context) -> Self +} + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension KFImageProtocol { + public var options: KingfisherParsedOptionsInfo { + get { context.options } + nonmutating set { context.options = newValue } + } + + public var onFailureDelegate: Delegate { context.onFailureDelegate } + public var onSuccessDelegate: Delegate { context.onSuccessDelegate } + public var onProgressDelegate: Delegate<(Int64, Int64), Void> { context.onProgressDelegate } + + public var delegateObserver: AnyObject { context } +} + + +#endif diff --git a/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageRenderer.swift b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageRenderer.swift new file mode 100644 index 0000000..5203b4e --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/SwiftUI/KFImageRenderer.swift @@ -0,0 +1,129 @@ +// +// KFImageRenderer.swift +// Kingfisher +// +// Created by onevcat on 2021/05/08. +// +// Copyright (c) 2021 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if canImport(SwiftUI) && canImport(Combine) +import SwiftUI +import Combine + +/// A Kingfisher compatible SwiftUI `View` to load an image from a `Source`. +/// Declaring a `KFImage` in a `View`'s body to trigger loading from the given `Source`. +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +struct KFImageRenderer : View where HoldingView: KFImageHoldingView { + + @StateObject var binder: KFImage.ImageBinder = .init() + let context: KFImage.Context + + var body: some View { + if context.startLoadingBeforeViewAppear && !binder.loadingOrSucceeded && !binder.animating { + binder.markLoading() + DispatchQueue.main.async { binder.start(context: context) } + } + + return ZStack { + renderedImage().opacity(binder.loaded ? 1.0 : 0.0) + if binder.loadedImage == nil { + ZStack { + if let placeholder = context.placeholder { + placeholder(binder.progress) + } else { + Color.clear + } + } + .onAppear { [weak binder = self.binder] in + guard let binder = binder else { + return + } + if !binder.loadingOrSucceeded { + binder.start(context: context) + } + } + .onDisappear { [weak binder = self.binder] in + guard let binder = binder else { + return + } + if context.cancelOnDisappear { + binder.cancel() + } + } + } + } + // Workaround for https://github.com/onevcat/Kingfisher/issues/1988 + // on iOS 16 there seems to be a bug that when in a List, the `onAppear` of the `ZStack` above in the + // `binder.loadedImage == nil` not get called. Adding this empty `onAppear` fixes it and the life cycle can + // work again. + // + // There is another "fix": adding an `else` clause and put a `Color.clear` there. But I believe this `onAppear` + // should work better. + // + // It should be a bug in iOS 16, I guess it is some kinds of over-optimization in list cell loading caused it. + .onAppear() + } + + @ViewBuilder + private func renderedImage() -> some View { + let configuredImage = context.configurations + .reduce(HoldingView.created(from: binder.loadedImage, context: context)) { + current, config in config(current) + } + if let contentConfiguration = context.contentConfiguration { + contentConfiguration(configuredImage) + } else { + configuredImage + } + } +} + +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension Image { + // Creates an Image with either UIImage or NSImage. + init(crossPlatformImage: KFCrossPlatformImage?) { + #if canImport(UIKit) + self.init(uiImage: crossPlatformImage ?? KFCrossPlatformImage()) + #elseif canImport(AppKit) + self.init(nsImage: crossPlatformImage ?? KFCrossPlatformImage()) + #endif + } +} + +#if canImport(UIKit) +@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *) +extension UIImage.Orientation { + func toSwiftUI() -> Image.Orientation { + switch self { + case .down: return .down + case .up: return .up + case .left: return .left + case .right: return .right + case .upMirrored: return .upMirrored + case .downMirrored: return .downMirrored + case .leftMirrored: return .leftMirrored + case .rightMirrored: return .rightMirrored + @unknown default: return .up + } + } +} +#endif +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Utility/Box.swift b/Demo/Pods/Kingfisher/Sources/Utility/Box.swift new file mode 100644 index 0000000..0303a6e --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/Box.swift @@ -0,0 +1,34 @@ +// +// Box.swift +// Kingfisher +// +// Created by Wei Wang on 2018/3/17. +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +class Box { + var value: T + + init(_ value: T) { + self.value = value + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Utility/CallbackQueue.swift b/Demo/Pods/Kingfisher/Sources/Utility/CallbackQueue.swift new file mode 100644 index 0000000..822af28 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/CallbackQueue.swift @@ -0,0 +1,83 @@ +// +// CallbackQueue.swift +// Kingfisher +// +// Created by onevcat on 2018/10/15. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +public typealias ExecutionQueue = CallbackQueue + +/// Represents callback queue behaviors when an calling of closure be dispatched. +/// +/// - asyncMain: Dispatch the calling to `DispatchQueue.main` with an `async` behavior. +/// - currentMainOrAsync: Dispatch the calling to `DispatchQueue.main` with an `async` behavior if current queue is not +/// `.main`. Otherwise, call the closure immediately in current main queue. +/// - untouch: Do not change the calling queue for closure. +/// - dispatch: Dispatches to a specified `DispatchQueue`. +public enum CallbackQueue { + /// Dispatch the calling to `DispatchQueue.main` with an `async` behavior. + case mainAsync + /// Dispatch the calling to `DispatchQueue.main` with an `async` behavior if current queue is not + /// `.main`. Otherwise, call the closure immediately in current main queue. + case mainCurrentOrAsync + /// Do not change the calling queue for closure. + case untouch + /// Dispatches to a specified `DispatchQueue`. + case dispatch(DispatchQueue) + + public func execute(_ block: @escaping () -> Void) { + switch self { + case .mainAsync: + DispatchQueue.main.async { block() } + case .mainCurrentOrAsync: + DispatchQueue.main.safeAsync { block() } + case .untouch: + block() + case .dispatch(let queue): + queue.async { block() } + } + } + + var queue: DispatchQueue { + switch self { + case .mainAsync: return .main + case .mainCurrentOrAsync: return .main + case .untouch: return OperationQueue.current?.underlyingQueue ?? .main + case .dispatch(let queue): return queue + } + } +} + +extension DispatchQueue { + // This method will dispatch the `block` to self. + // If `self` is the main queue, and current thread is main thread, the block + // will be invoked immediately instead of being dispatched. + func safeAsync(_ block: @escaping () -> Void) { + if self === DispatchQueue.main && Thread.isMainThread { + block() + } else { + async { block() } + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Utility/Delegate.swift b/Demo/Pods/Kingfisher/Sources/Utility/Delegate.swift new file mode 100644 index 0000000..9caa1a6 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/Delegate.swift @@ -0,0 +1,132 @@ +// +// Delegate.swift +// Kingfisher +// +// Created by onevcat on 2018/10/10. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +/// A class that keeps a weakly reference for `self` when implementing `onXXX` behaviors. +/// Instead of remembering to keep `self` as weak in a stored closure: +/// +/// ```swift +/// // MyClass.swift +/// var onDone: (() -> Void)? +/// func done() { +/// onDone?() +/// } +/// +/// // ViewController.swift +/// var obj: MyClass? +/// +/// func doSomething() { +/// obj = MyClass() +/// obj!.onDone = { [weak self] in +/// self?.reportDone() +/// } +/// } +/// ``` +/// +/// You can create a `Delegate` and observe on `self`. Now, there is no retain cycle inside: +/// +/// ```swift +/// // MyClass.swift +/// let onDone = Delegate<(), Void>() +/// func done() { +/// onDone.call() +/// } +/// +/// // ViewController.swift +/// var obj: MyClass? +/// +/// func doSomething() { +/// obj = MyClass() +/// obj!.onDone.delegate(on: self) { (self, _) +/// // `self` here is shadowed and does not keep a strong ref. +/// // So you can release both `MyClass` instance and `ViewController` instance. +/// self.reportDone() +/// } +/// } +/// ``` +/// +public class Delegate { + public init() {} + + private var block: ((Input) -> Output?)? + public func delegate(on target: T, block: ((T, Input) -> Output)?) { + self.block = { [weak target] input in + guard let target = target else { return nil } + return block?(target, input) + } + } + + public func call(_ input: Input) -> Output? { + return block?(input) + } + + public func callAsFunction(_ input: Input) -> Output? { + return call(input) + } +} + +extension Delegate where Input == Void { + public func call() -> Output? { + return call(()) + } + + public func callAsFunction() -> Output? { + return call() + } +} + +extension Delegate where Input == Void, Output: OptionalProtocol { + public func call() -> Output { + return call(()) + } + + public func callAsFunction() -> Output { + return call() + } +} + +extension Delegate where Output: OptionalProtocol { + public func call(_ input: Input) -> Output { + if let result = block?(input) { + return result + } else { + return Output._createNil + } + } + + public func callAsFunction(_ input: Input) -> Output { + return call(input) + } +} + +public protocol OptionalProtocol { + static var _createNil: Self { get } +} +extension Optional : OptionalProtocol { + public static var _createNil: Optional { + return nil + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Utility/ExtensionHelpers.swift b/Demo/Pods/Kingfisher/Sources/Utility/ExtensionHelpers.swift new file mode 100644 index 0000000..22b2063 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/ExtensionHelpers.swift @@ -0,0 +1,117 @@ +// +// ExtensionHelpers.swift +// Kingfisher +// +// Created by onevcat on 2018/09/28. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +extension CGFloat { + var isEven: Bool { + return truncatingRemainder(dividingBy: 2.0) == 0 + } +} + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) +import AppKit +extension NSBezierPath { + convenience init(roundedRect rect: NSRect, topLeftRadius: CGFloat, topRightRadius: CGFloat, + bottomLeftRadius: CGFloat, bottomRightRadius: CGFloat) + { + self.init() + + let maxCorner = min(rect.width, rect.height) / 2 + + let radiusTopLeft = min(maxCorner, max(0, topLeftRadius)) + let radiusTopRight = min(maxCorner, max(0, topRightRadius)) + let radiusBottomLeft = min(maxCorner, max(0, bottomLeftRadius)) + let radiusBottomRight = min(maxCorner, max(0, bottomRightRadius)) + + guard !rect.isEmpty else { + return + } + + let topLeft = NSPoint(x: rect.minX, y: rect.maxY) + let topRight = NSPoint(x: rect.maxX, y: rect.maxY) + let bottomRight = NSPoint(x: rect.maxX, y: rect.minY) + + move(to: NSPoint(x: rect.midX, y: rect.maxY)) + appendArc(from: topLeft, to: rect.origin, radius: radiusTopLeft) + appendArc(from: rect.origin, to: bottomRight, radius: radiusBottomLeft) + appendArc(from: bottomRight, to: topRight, radius: radiusBottomRight) + appendArc(from: topRight, to: topLeft, radius: radiusTopRight) + close() + } + + convenience init(roundedRect rect: NSRect, byRoundingCorners corners: RectCorner, radius: CGFloat) { + let radiusTopLeft = corners.contains(.topLeft) ? radius : 0 + let radiusTopRight = corners.contains(.topRight) ? radius : 0 + let radiusBottomLeft = corners.contains(.bottomLeft) ? radius : 0 + let radiusBottomRight = corners.contains(.bottomRight) ? radius : 0 + + self.init(roundedRect: rect, topLeftRadius: radiusTopLeft, topRightRadius: radiusTopRight, + bottomLeftRadius: radiusBottomLeft, bottomRightRadius: radiusBottomRight) + } +} + +extension KFCrossPlatformImage { + // macOS does not support scale. This is just for code compatibility across platforms. + convenience init?(data: Data, scale: CGFloat) { + self.init(data: data) + } +} +#endif + +#if canImport(UIKit) +import UIKit +extension RectCorner { + var uiRectCorner: UIRectCorner { + + var result: UIRectCorner = [] + + if contains(.topLeft) { result.insert(.topLeft) } + if contains(.topRight) { result.insert(.topRight) } + if contains(.bottomLeft) { result.insert(.bottomLeft) } + if contains(.bottomRight) { result.insert(.bottomRight) } + + return result + } +} +#endif + +extension Date { + var isPast: Bool { + return isPast(referenceDate: Date()) + } + + func isPast(referenceDate: Date) -> Bool { + return timeIntervalSince(referenceDate) <= 0 + } + + // `Date` in memory is a wrap for `TimeInterval`. But in file attribute it can only accept `Int` number. + // By default the system will `round` it. But it is not friendly for testing purpose. + // So we always `ceil` the value when used for file attributes. + var fileAttributeDate: Date { + return Date(timeIntervalSince1970: ceil(timeIntervalSince1970)) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Utility/Result.swift b/Demo/Pods/Kingfisher/Sources/Utility/Result.swift new file mode 100644 index 0000000..dcdb08b --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/Result.swift @@ -0,0 +1,50 @@ +// +// Result.swift +// Kingfisher +// +// Created by onevcat on 2018/09/22. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +// These helper methods are not public since we do not want them to be exposed or cause any conflicting. +// However, they are just wrapper of `ResultUtil` static methods. +extension Result where Failure: Error { + + /// Evaluates the given transform closures to create a single output value. + /// + /// - Parameters: + /// - onSuccess: A closure that transforms the success value. + /// - onFailure: A closure that transforms the error value. + /// - Returns: A single `Output` value. + func match( + onSuccess: (Success) -> Output, + onFailure: (Failure) -> Output) -> Output + { + switch self { + case let .success(value): + return onSuccess(value) + case let .failure(error): + return onFailure(error) + } + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Utility/Runtime.swift b/Demo/Pods/Kingfisher/Sources/Utility/Runtime.swift new file mode 100644 index 0000000..d5818e2 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/Runtime.swift @@ -0,0 +1,35 @@ +// +// Runtime.swift +// Kingfisher +// +// Created by Wei Wang on 2018/10/12. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation + +func getAssociatedObject(_ object: Any, _ key: UnsafeRawPointer) -> T? { + return objc_getAssociatedObject(object, key) as? T +} + +func setRetainedAssociatedObject(_ object: Any, _ key: UnsafeRawPointer, _ value: T) { + objc_setAssociatedObject(object, key, value, .OBJC_ASSOCIATION_RETAIN_NONATOMIC) +} diff --git a/Demo/Pods/Kingfisher/Sources/Utility/SizeExtensions.swift b/Demo/Pods/Kingfisher/Sources/Utility/SizeExtensions.swift new file mode 100644 index 0000000..19d05d6 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/SizeExtensions.swift @@ -0,0 +1,110 @@ +// +// SizeExtensions.swift +// Kingfisher +// +// Created by onevcat on 2018/09/28. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import CoreGraphics + +extension CGSize: KingfisherCompatibleValue {} +extension KingfisherWrapper where Base == CGSize { + + /// Returns a size by resizing the `base` size to a target size under a given content mode. + /// + /// - Parameters: + /// - size: The target size to resize to. + /// - contentMode: Content mode of the target size should be when resizing. + /// - Returns: The resized size under the given `ContentMode`. + public func resize(to size: CGSize, for contentMode: ContentMode) -> CGSize { + switch contentMode { + case .aspectFit: + return constrained(size) + case .aspectFill: + return filling(size) + case .none: + return size + } + } + + /// Returns a size by resizing the `base` size by making it aspect fitting the given `size`. + /// + /// - Parameter size: The size in which the `base` should fit in. + /// - Returns: The size fitted in by the input `size`, while keeps `base` aspect. + public func constrained(_ size: CGSize) -> CGSize { + let aspectWidth = round(aspectRatio * size.height) + let aspectHeight = round(size.width / aspectRatio) + + return aspectWidth > size.width ? + CGSize(width: size.width, height: aspectHeight) : + CGSize(width: aspectWidth, height: size.height) + } + + /// Returns a size by resizing the `base` size by making it aspect filling the given `size`. + /// + /// - Parameter size: The size in which the `base` should fill. + /// - Returns: The size be filled by the input `size`, while keeps `base` aspect. + public func filling(_ size: CGSize) -> CGSize { + let aspectWidth = round(aspectRatio * size.height) + let aspectHeight = round(size.width / aspectRatio) + + return aspectWidth < size.width ? + CGSize(width: size.width, height: aspectHeight) : + CGSize(width: aspectWidth, height: size.height) + } + + /// Returns a `CGRect` for which the `base` size is constrained to an input `size` at a given `anchor` point. + /// + /// - Parameters: + /// - size: The size in which the `base` should be constrained to. + /// - anchor: An anchor point in which the size constraint should happen. + /// - Returns: The result `CGRect` for the constraint operation. + public func constrainedRect(for size: CGSize, anchor: CGPoint) -> CGRect { + + let unifiedAnchor = CGPoint(x: anchor.x.clamped(to: 0.0...1.0), + y: anchor.y.clamped(to: 0.0...1.0)) + + let x = unifiedAnchor.x * base.width - unifiedAnchor.x * size.width + let y = unifiedAnchor.y * base.height - unifiedAnchor.y * size.height + let r = CGRect(x: x, y: y, width: size.width, height: size.height) + + let ori = CGRect(origin: .zero, size: base) + return ori.intersection(r) + } + + private var aspectRatio: CGFloat { + return base.height == 0.0 ? 1.0 : base.width / base.height + } +} + +extension CGRect { + func scaled(_ scale: CGFloat) -> CGRect { + return CGRect(x: origin.x * scale, y: origin.y * scale, + width: size.width * scale, height: size.height * scale) + } +} + +extension Comparable { + func clamped(to limits: ClosedRange) -> Self { + return min(max(self, limits.lowerBound), limits.upperBound) + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Utility/String+MD5.swift b/Demo/Pods/Kingfisher/Sources/Utility/String+MD5.swift new file mode 100644 index 0000000..59586b5 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Utility/String+MD5.swift @@ -0,0 +1,278 @@ +// +// String+MD5.swift +// Kingfisher +// +// Created by Wei Wang on 18/09/25. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +import Foundation +import CommonCrypto + +extension String: KingfisherCompatibleValue { } +extension KingfisherWrapper where Base == String { + var md5: String { + guard let data = base.data(using: .utf8) else { + return base + } + + let message = data.withUnsafeBytes { (bytes: UnsafeRawBufferPointer) in + return [UInt8](bytes) + } + + let MD5Calculator = MD5(message) + let MD5Data = MD5Calculator.calculate() + + var MD5String = String() + for c in MD5Data { + MD5String += String(format: "%02x", c) + } + return MD5String + } + + var ext: String? { + var ext = "" + if let index = base.lastIndex(of: ".") { + let extRange = base.index(index, offsetBy: 1).. 0 ? String(firstSeg) : nil + } +} + +// array of bytes, little-endian representation +func arrayOfBytes(_ value: T, length: Int? = nil) -> [UInt8] { + let totalBytes = length ?? (MemoryLayout.size * 8) + + let valuePointer = UnsafeMutablePointer.allocate(capacity: 1) + valuePointer.pointee = value + + let bytes = valuePointer.withMemoryRebound(to: UInt8.self, capacity: totalBytes) { (bytesPointer) -> [UInt8] in + var bytes = [UInt8](repeating: 0, count: totalBytes) + for j in 0...size, totalBytes) { + bytes[totalBytes - 1 - j] = (bytesPointer + j).pointee + } + return bytes + } + + valuePointer.deinitialize(count: 1) + valuePointer.deallocate() + + return bytes +} + +extension Int { + // Array of bytes with optional padding (little-endian) + func bytes(_ totalBytes: Int = MemoryLayout.size) -> [UInt8] { + return arrayOfBytes(self, length: totalBytes) + } + +} + +protocol HashProtocol { + var message: [UInt8] { get } + // Common part for hash calculation. Prepare header data. + func prepare(_ len: Int) -> [UInt8] +} + +extension HashProtocol { + + func prepare(_ len: Int) -> [UInt8] { + var tmpMessage = message + + // Step 1. Append Padding Bits + tmpMessage.append(0x80) // append one bit (UInt8 with one bit) to message + + // append "0" bit until message length in bits ≡ 448 (mod 512) + var msgLength = tmpMessage.count + var counter = 0 + + while msgLength % len != (len - 8) { + counter += 1 + msgLength += 1 + } + + tmpMessage += [UInt8](repeating: 0, count: counter) + return tmpMessage + } +} + +func toUInt32Array(_ slice: ArraySlice) -> [UInt32] { + var result = [UInt32]() + result.reserveCapacity(16) + + for idx in stride(from: slice.startIndex, to: slice.endIndex, by: MemoryLayout.size) { + let d0 = UInt32(slice[idx.advanced(by: 3)]) << 24 + let d1 = UInt32(slice[idx.advanced(by: 2)]) << 16 + let d2 = UInt32(slice[idx.advanced(by: 1)]) << 8 + let d3 = UInt32(slice[idx]) + let val: UInt32 = d0 | d1 | d2 | d3 + + result.append(val) + } + return result +} + +struct BytesIterator: IteratorProtocol { + + let chunkSize: Int + let data: [UInt8] + + init(chunkSize: Int, data: [UInt8]) { + self.chunkSize = chunkSize + self.data = data + } + + var offset = 0 + + mutating func next() -> ArraySlice? { + let end = min(chunkSize, data.count - offset) + let result = data[offset.. 0 ? result : nil + } +} + +struct BytesSequence: Sequence { + let chunkSize: Int + let data: [UInt8] + + func makeIterator() -> BytesIterator { + return BytesIterator(chunkSize: chunkSize, data: data) + } +} + +func rotateLeft(_ value: UInt32, bits: UInt32) -> UInt32 { + return ((value << bits) & 0xFFFFFFFF) | (value >> (32 - bits)) +} + +class MD5: HashProtocol { + + let message: [UInt8] + + init (_ message: [UInt8]) { + self.message = message + } + + // specifies the per-round shift amounts + private let shifts: [UInt32] = [7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22, + 5, 9, 14, 20, 5, 9, 14, 20, 5, 9, 14, 20, 5, 9, 14, 20, + 4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23, + 6, 10, 15, 21, 6, 10, 15, 21, 6, 10, 15, 21, 6, 10, 15, 21] + + // binary integer part of the sines of integers (Radians) + private let sines: [UInt32] = [0xd76aa478, 0xe8c7b756, 0x242070db, 0xc1bdceee, + 0xf57c0faf, 0x4787c62a, 0xa8304613, 0xfd469501, + 0x698098d8, 0x8b44f7af, 0xffff5bb1, 0x895cd7be, + 0x6b901122, 0xfd987193, 0xa679438e, 0x49b40821, + 0xf61e2562, 0xc040b340, 0x265e5a51, 0xe9b6c7aa, + 0xd62f105d, 0x02441453, 0xd8a1e681, 0xe7d3fbc8, + 0x21e1cde6, 0xc33707d6, 0xf4d50d87, 0x455a14ed, + 0xa9e3e905, 0xfcefa3f8, 0x676f02d9, 0x8d2a4c8a, + 0xfffa3942, 0x8771f681, 0x6d9d6122, 0xfde5380c, + 0xa4beea44, 0x4bdecfa9, 0xf6bb4b60, 0xbebfbc70, + 0x289b7ec6, 0xeaa127fa, 0xd4ef3085, 0x4881d05, + 0xd9d4d039, 0xe6db99e5, 0x1fa27cf8, 0xc4ac5665, + 0xf4292244, 0x432aff97, 0xab9423a7, 0xfc93a039, + 0x655b59c3, 0x8f0ccc92, 0xffeff47d, 0x85845dd1, + 0x6fa87e4f, 0xfe2ce6e0, 0xa3014314, 0x4e0811a1, + 0xf7537e82, 0xbd3af235, 0x2ad7d2bb, 0xeb86d391] + + private let hashes: [UInt32] = [0x67452301, 0xefcdab89, 0x98badcfe, 0x10325476] + + func calculate() -> [UInt8] { + var tmpMessage = prepare(64) + tmpMessage.reserveCapacity(tmpMessage.count + 4) + + // hash values + var hh = hashes + + // Step 2. Append Length a 64-bit representation of lengthInBits + let lengthInBits = (message.count * 8) + let lengthBytes = lengthInBits.bytes(64 / 8) + tmpMessage += lengthBytes.reversed() + + // Process the message in successive 512-bit chunks: + let chunkSizeBytes = 512 / 8 // 64 + + for chunk in BytesSequence(chunkSize: chunkSizeBytes, data: tmpMessage) { + // break chunk into sixteen 32-bit words M[j], 0 ≤ j ≤ 15 + let M = toUInt32Array(chunk) + assert(M.count == 16, "Invalid array") + + // Initialize hash value for this chunk: + var A: UInt32 = hh[0] + var B: UInt32 = hh[1] + var C: UInt32 = hh[2] + var D: UInt32 = hh[3] + + var dTemp: UInt32 = 0 + + // Main loop + for j in 0 ..< sines.count { + var g = 0 + var F: UInt32 = 0 + + switch j { + case 0...15: + F = (B & C) | ((~B) & D) + g = j + case 16...31: + F = (D & B) | (~D & C) + g = (5 * j + 1) % 16 + case 32...47: + F = B ^ C ^ D + g = (3 * j + 5) % 16 + case 48...63: + F = C ^ (B | (~D)) + g = (7 * j) % 16 + default: + break + } + dTemp = D + D = C + C = B + B = B &+ rotateLeft((A &+ F &+ sines[j] &+ M[g]), bits: shifts[j]) + A = dTemp + } + + hh[0] = hh[0] &+ A + hh[1] = hh[1] &+ B + hh[2] = hh[2] &+ C + hh[3] = hh[3] &+ D + } + var result = [UInt8]() + result.reserveCapacity(hh.count / 4) + + hh.forEach { + let itemLE = $0.littleEndian + let r1 = UInt8(itemLE & 0xff) + let r2 = UInt8((itemLE >> 8) & 0xff) + let r3 = UInt8((itemLE >> 16) & 0xff) + let r4 = UInt8((itemLE >> 24) & 0xff) + result += [r1, r2, r3, r4] + } + return result + } +} diff --git a/Demo/Pods/Kingfisher/Sources/Views/AnimatedImageView.swift b/Demo/Pods/Kingfisher/Sources/Views/AnimatedImageView.swift new file mode 100644 index 0000000..f679340 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Views/AnimatedImageView.swift @@ -0,0 +1,686 @@ +// +// AnimatableImageView.swift +// Kingfisher +// +// Created by bl4ckra1sond3tre on 4/22/16. +// +// The AnimatableImageView, AnimatedFrame and Animator is a modified version of +// some classes from kaishin's Gifu project (https://github.com/kaishin/Gifu) +// +// The MIT License (MIT) +// +// Copyright (c) 2019 Reda Lemeden. +// +// Permission is hereby granted, free of charge, to any person obtaining a copy of +// this software and associated documentation files (the "Software"), to deal in +// the Software without restriction, including without limitation the rights to +// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of +// the Software, and to permit persons to whom the Software is furnished to do so, +// subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in all +// copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +// FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +// COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +// IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +// CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +// +// The name and characters used in the demo of this software are property of their +// respective owners. + +#if !os(watchOS) +#if canImport(UIKit) +import UIKit +import ImageIO + +/// Protocol of `AnimatedImageView`. +public protocol AnimatedImageViewDelegate: AnyObject { + + /// Called after the animatedImageView has finished each animation loop. + /// + /// - Parameters: + /// - imageView: The `AnimatedImageView` that is being animated. + /// - count: The looped count. + func animatedImageView(_ imageView: AnimatedImageView, didPlayAnimationLoops count: UInt) + + /// Called after the `AnimatedImageView` has reached the max repeat count. + /// + /// - Parameter imageView: The `AnimatedImageView` that is being animated. + func animatedImageViewDidFinishAnimating(_ imageView: AnimatedImageView) +} + +extension AnimatedImageViewDelegate { + public func animatedImageView(_ imageView: AnimatedImageView, didPlayAnimationLoops count: UInt) {} + public func animatedImageViewDidFinishAnimating(_ imageView: AnimatedImageView) {} +} + +let KFRunLoopModeCommon = RunLoop.Mode.common + +/// Represents a subclass of `UIImageView` for displaying animated image. +/// Different from showing animated image in a normal `UIImageView` (which load all frames at one time), +/// `AnimatedImageView` only tries to load several frames (defined by `framePreloadCount`) to reduce memory usage. +/// It provides a tradeoff between memory usage and CPU time. If you have a memory issue when using a normal image +/// view to load GIF data, you could give this class a try. +/// +/// Kingfisher supports setting GIF animated data to either `UIImageView` and `AnimatedImageView` out of box. So +/// it would be fairly easy to switch between them. +open class AnimatedImageView: UIImageView { + /// Proxy object for preventing a reference cycle between the `CADDisplayLink` and `AnimatedImageView`. + class TargetProxy { + private weak var target: AnimatedImageView? + + init(target: AnimatedImageView) { + self.target = target + } + + @objc func onScreenUpdate() { + target?.updateFrameIfNeeded() + } + } + + /// Enumeration that specifies repeat count of GIF + public enum RepeatCount: Equatable { + case once + case finite(count: UInt) + case infinite + + public static func ==(lhs: RepeatCount, rhs: RepeatCount) -> Bool { + switch (lhs, rhs) { + case let (.finite(l), .finite(r)): + return l == r + case (.once, .once), + (.infinite, .infinite): + return true + case (.once, .finite(let count)), + (.finite(let count), .once): + return count == 1 + case (.once, _), + (.infinite, _), + (.finite, _): + return false + } + } + } + + // MARK: - Public property + /// Whether automatically play the animation when the view become visible. Default is `true`. + public var autoPlayAnimatedImage = true + + /// The count of the frames should be preloaded before shown. + public var framePreloadCount = 10 + + /// Specifies whether the GIF frames should be pre-scaled to the image view's size or not. + /// If the downloaded image is larger than the image view's size, it will help to reduce some memory use. + /// Default is `true`. + public var needsPrescaling = true + + /// Decode the GIF frames in background thread before using. It will decode frames data and do a off-screen + /// rendering to extract pixel information in background. This can reduce the main thread CPU usage. + public var backgroundDecode = true + + /// The animation timer's run loop mode. Default is `RunLoop.Mode.common`. + /// Set this property to `RunLoop.Mode.default` will make the animation pause during UIScrollView scrolling. + public var runLoopMode = KFRunLoopModeCommon { + willSet { + guard runLoopMode != newValue else { return } + stopAnimating() + displayLink.remove(from: .main, forMode: runLoopMode) + displayLink.add(to: .main, forMode: newValue) + startAnimating() + } + } + + /// The repeat count. The animated image will keep animate until it the loop count reaches this value. + /// Setting this value to another one will reset current animation. + /// + /// Default is `.infinite`, which means the animation will last forever. + public var repeatCount = RepeatCount.infinite { + didSet { + if oldValue != repeatCount { + reset() + setNeedsDisplay() + layer.setNeedsDisplay() + } + } + } + + /// Delegate of this `AnimatedImageView` object. See `AnimatedImageViewDelegate` protocol for more. + public weak var delegate: AnimatedImageViewDelegate? + + /// The `Animator` instance that holds the frames of a specific image in memory. + public private(set) var animator: Animator? + + // MARK: - Private property + // Dispatch queue used for preloading images. + private lazy var preloadQueue: DispatchQueue = { + return DispatchQueue(label: "com.onevcat.Kingfisher.Animator.preloadQueue") + }() + + // A flag to avoid invalidating the displayLink on deinit if it was never created, because displayLink is so lazy. + private var isDisplayLinkInitialized: Bool = false + + // A display link that keeps calling the `updateFrame` method on every screen refresh. + private lazy var displayLink: CADisplayLink = { + isDisplayLinkInitialized = true + let displayLink = CADisplayLink(target: TargetProxy(target: self), selector: #selector(TargetProxy.onScreenUpdate)) + displayLink.add(to: .main, forMode: runLoopMode) + displayLink.isPaused = true + return displayLink + }() + + // MARK: - Override + override open var image: KFCrossPlatformImage? { + didSet { + if image != oldValue { + reset() + } + setNeedsDisplay() + layer.setNeedsDisplay() + } + } + + open override var isHighlighted: Bool { + get { + super.isHighlighted + } + set { + // Highlighted image is unsupported for animated images. + // See https://github.com/onevcat/Kingfisher/issues/1679 + if displayLink.isPaused { + super.isHighlighted = newValue + } + } + } + + deinit { + if isDisplayLinkInitialized { + displayLink.invalidate() + } + } + + override open var isAnimating: Bool { + if isDisplayLinkInitialized { + return !displayLink.isPaused + } else { + return super.isAnimating + } + } + + /// Starts the animation. + override open func startAnimating() { + guard !isAnimating else { return } + guard let animator = animator else { return } + guard !animator.isReachMaxRepeatCount else { return } + + displayLink.isPaused = false + } + + /// Stops the animation. + override open func stopAnimating() { + super.stopAnimating() + if isDisplayLinkInitialized { + displayLink.isPaused = true + } + } + + override open func display(_ layer: CALayer) { + layer.contents = animator?.currentFrameImage?.cgImage ?? image?.cgImage + } + + override open func didMoveToWindow() { + super.didMoveToWindow() + didMove() + } + + override open func didMoveToSuperview() { + super.didMoveToSuperview() + didMove() + } + + // This is for back compatibility that using regular `UIImageView` to show animated image. + override func shouldPreloadAllAnimation() -> Bool { + return false + } + + // Reset the animator. + private func reset() { + animator = nil + if let image = image, let imageSource = image.kf.imageSource { + let targetSize = bounds.scaled(UIScreen.main.scale).size + let animator = Animator( + imageSource: imageSource, + contentMode: contentMode, + size: targetSize, + imageSize: image.kf.size, + imageScale: image.kf.scale, + framePreloadCount: framePreloadCount, + repeatCount: repeatCount, + preloadQueue: preloadQueue) + animator.delegate = self + animator.needsPrescaling = needsPrescaling + animator.backgroundDecode = backgroundDecode + animator.prepareFramesAsynchronously() + self.animator = animator + } + didMove() + } + + private func didMove() { + if autoPlayAnimatedImage && animator != nil { + if let _ = superview, let _ = window { + startAnimating() + } else { + stopAnimating() + } + } + } + + /// Update the current frame with the displayLink duration. + private func updateFrameIfNeeded() { + guard let animator = animator else { + return + } + + guard !animator.isFinished else { + stopAnimating() + delegate?.animatedImageViewDidFinishAnimating(self) + return + } + + let duration: CFTimeInterval + + // CA based display link is opt-out from ProMotion by default. + // So the duration and its FPS might not match. + // See [#718](https://github.com/onevcat/Kingfisher/issues/718) + // By setting CADisableMinimumFrameDuration to YES in Info.plist may + // cause the preferredFramesPerSecond being 0 + let preferredFramesPerSecond = displayLink.preferredFramesPerSecond + if preferredFramesPerSecond == 0 { + duration = displayLink.duration + } else { + // Some devices (like iPad Pro 10.5) will have a different FPS. + duration = 1.0 / TimeInterval(preferredFramesPerSecond) + } + + animator.shouldChangeFrame(with: duration) { [weak self] hasNewFrame in + if hasNewFrame { + self?.layer.setNeedsDisplay() + } + } + } +} + +protocol AnimatorDelegate: AnyObject { + func animator(_ animator: AnimatedImageView.Animator, didPlayAnimationLoops count: UInt) +} + +extension AnimatedImageView: AnimatorDelegate { + func animator(_ animator: Animator, didPlayAnimationLoops count: UInt) { + delegate?.animatedImageView(self, didPlayAnimationLoops: count) + } +} + +extension AnimatedImageView { + + // Represents a single frame in a GIF. + struct AnimatedFrame { + + // The image to display for this frame. Its value is nil when the frame is removed from the buffer. + let image: UIImage? + + // The duration that this frame should remain active. + let duration: TimeInterval + + // A placeholder frame with no image assigned. + // Used to replace frames that are no longer needed in the animation. + var placeholderFrame: AnimatedFrame { + return AnimatedFrame(image: nil, duration: duration) + } + + // Whether this frame instance contains an image or not. + var isPlaceholder: Bool { + return image == nil + } + + // Returns a new instance from an optional image. + // + // - parameter image: An optional `UIImage` instance to be assigned to the new frame. + // - returns: An `AnimatedFrame` instance. + func makeAnimatedFrame(image: UIImage?) -> AnimatedFrame { + return AnimatedFrame(image: image, duration: duration) + } + } +} + +extension AnimatedImageView { + + // MARK: - Animator + + /// An animator which used to drive the data behind `AnimatedImageView`. + public class Animator { + private let size: CGSize + + private let imageSize: CGSize + private let imageScale: CGFloat + + /// The maximum count of image frames that needs preload. + public let maxFrameCount: Int + + private let imageSource: CGImageSource + private let maxRepeatCount: RepeatCount + + private let maxTimeStep: TimeInterval = 1.0 + private let animatedFrames = SafeArray() + private var frameCount = 0 + private var timeSinceLastFrameChange: TimeInterval = 0.0 + private var currentRepeatCount: UInt = 0 + + var isFinished: Bool = false + + var needsPrescaling = true + + var backgroundDecode = true + + weak var delegate: AnimatorDelegate? + + // Total duration of one animation loop + var loopDuration: TimeInterval = 0 + + /// The image of the current frame. + public var currentFrameImage: UIImage? { + return frame(at: currentFrameIndex) + } + + /// The duration of the current active frame duration. + public var currentFrameDuration: TimeInterval { + return duration(at: currentFrameIndex) + } + + /// The index of the current animation frame. + public internal(set) var currentFrameIndex = 0 { + didSet { + previousFrameIndex = oldValue + } + } + + var previousFrameIndex = 0 { + didSet { + preloadQueue.async { + self.updatePreloadedFrames() + } + } + } + + var isReachMaxRepeatCount: Bool { + switch maxRepeatCount { + case .once: + return currentRepeatCount >= 1 + case .finite(let maxCount): + return currentRepeatCount >= maxCount + case .infinite: + return false + } + } + + /// Whether the current frame is the last frame or not in the animation sequence. + public var isLastFrame: Bool { + return currentFrameIndex == frameCount - 1 + } + + var preloadingIsNeeded: Bool { + return maxFrameCount < frameCount - 1 + } + + var contentMode = UIView.ContentMode.scaleToFill + + private lazy var preloadQueue: DispatchQueue = { + return DispatchQueue(label: "com.onevcat.Kingfisher.Animator.preloadQueue") + }() + + /// Creates an animator with image source reference. + /// + /// - Parameters: + /// - source: The reference of animated image. + /// - mode: Content mode of the `AnimatedImageView`. + /// - size: Size of the `AnimatedImageView`. + /// - imageSize: Size of the `KingfisherWrapper`. + /// - imageScale: Scale of the `KingfisherWrapper`. + /// - count: Count of frames needed to be preloaded. + /// - repeatCount: The repeat count should this animator uses. + /// - preloadQueue: Dispatch queue used for preloading images. + init(imageSource source: CGImageSource, + contentMode mode: UIView.ContentMode, + size: CGSize, + imageSize: CGSize, + imageScale: CGFloat, + framePreloadCount count: Int, + repeatCount: RepeatCount, + preloadQueue: DispatchQueue) { + self.imageSource = source + self.contentMode = mode + self.size = size + self.imageSize = imageSize + self.imageScale = imageScale + self.maxFrameCount = count + self.maxRepeatCount = repeatCount + self.preloadQueue = preloadQueue + + GraphicsContext.begin(size: imageSize, scale: imageScale) + } + + deinit { + resetAnimatedFrames() + GraphicsContext.end() + } + + /// Gets the image frame of a given index. + /// - Parameter index: The index of desired image. + /// - Returns: The decoded image at the frame. `nil` if the index is out of bound or the image is not yet loaded. + public func frame(at index: Int) -> KFCrossPlatformImage? { + return animatedFrames[index]?.image + } + + public func duration(at index: Int) -> TimeInterval { + return animatedFrames[index]?.duration ?? .infinity + } + + func prepareFramesAsynchronously() { + frameCount = Int(CGImageSourceGetCount(imageSource)) + animatedFrames.reserveCapacity(frameCount) + preloadQueue.async { [weak self] in + self?.setupAnimatedFrames() + } + } + + func shouldChangeFrame(with duration: CFTimeInterval, handler: (Bool) -> Void) { + incrementTimeSinceLastFrameChange(with: duration) + + if currentFrameDuration > timeSinceLastFrameChange { + handler(false) + } else { + resetTimeSinceLastFrameChange() + incrementCurrentFrameIndex() + handler(true) + } + } + + private func setupAnimatedFrames() { + resetAnimatedFrames() + + var duration: TimeInterval = 0 + + (0.. maxFrameCount { return } + animatedFrames[index] = animatedFrames[index]?.makeAnimatedFrame(image: loadFrame(at: index)) + } + + self.loopDuration = duration + } + + private func resetAnimatedFrames() { + animatedFrames.removeAll() + } + + private func loadFrame(at index: Int) -> UIImage? { + let resize = needsPrescaling && size != .zero + let options: [CFString: Any]? + if resize { + options = [ + kCGImageSourceCreateThumbnailFromImageIfAbsent: true, + kCGImageSourceCreateThumbnailWithTransform: true, + kCGImageSourceShouldCacheImmediately: true, + kCGImageSourceThumbnailMaxPixelSize: max(size.width, size.height) + ] + } else { + options = nil + } + + guard let cgImage = CGImageSourceCreateImageAtIndex(imageSource, index, options as CFDictionary?) else { + return nil + } + + if #available(iOS 15, tvOS 15, *) { + // From iOS 15, a plain image loading causes iOS calling `-[_UIImageCGImageContent initWithCGImage:scale:]` + // in ImageIO, which holds the image ref on the creating thread. + // To get a workaround, create another image ref and use that to create the final image. This leads to + // some performance loss, but there is little we can do. + // https://github.com/onevcat/Kingfisher/issues/1844 + guard let context = GraphicsContext.current(size: imageSize, scale: imageScale, inverting: true, cgImage: cgImage), + let decodedImageRef = cgImage.decoded(on: context, scale: imageScale) + else { + return KFCrossPlatformImage(cgImage: cgImage) + } + + return KFCrossPlatformImage(cgImage: decodedImageRef) + } else { + let image = KFCrossPlatformImage(cgImage: cgImage) + if backgroundDecode { + guard let context = GraphicsContext.current(size: imageSize, scale: imageScale, inverting: true, cgImage: cgImage) else { + return image + } + return image.kf.decoded(on: context) + } else { + return image + } + } + } + + private func updatePreloadedFrames() { + guard preloadingIsNeeded else { + return + } + + let previousFrame = animatedFrames[previousFrameIndex] + animatedFrames[previousFrameIndex] = previousFrame?.placeholderFrame + // ensure the image dealloc in main thread + defer { + if let image = previousFrame?.image { + DispatchQueue.main.async { + _ = image + } + } + } + + preloadIndexes(start: currentFrameIndex).forEach { index in + guard let currentAnimatedFrame = animatedFrames[index] else { return } + if !currentAnimatedFrame.isPlaceholder { return } + animatedFrames[index] = currentAnimatedFrame.makeAnimatedFrame(image: loadFrame(at: index)) + } + } + + private func incrementCurrentFrameIndex() { + let wasLastFrame = isLastFrame + currentFrameIndex = increment(frameIndex: currentFrameIndex) + if isLastFrame { + currentRepeatCount += 1 + if isReachMaxRepeatCount { + isFinished = true + + // Notify the delegate here because the animation is stopping. + delegate?.animator(self, didPlayAnimationLoops: currentRepeatCount) + } + } else if wasLastFrame { + + // Notify the delegate that the loop completed + delegate?.animator(self, didPlayAnimationLoops: currentRepeatCount) + } + } + + private func incrementTimeSinceLastFrameChange(with duration: TimeInterval) { + timeSinceLastFrameChange += min(maxTimeStep, duration) + } + + private func resetTimeSinceLastFrameChange() { + timeSinceLastFrameChange -= currentFrameDuration + } + + private func increment(frameIndex: Int, by value: Int = 1) -> Int { + return (frameIndex + value) % frameCount + } + + private func preloadIndexes(start index: Int) -> [Int] { + let nextIndex = increment(frameIndex: index) + let lastIndex = increment(frameIndex: index, by: maxFrameCount) + + if lastIndex >= nextIndex { + return [Int](nextIndex...lastIndex) + } else { + return [Int](nextIndex.. { + private var array: Array = [] + private let lock = NSLock() + + subscript(index: Int) -> Element? { + get { + lock.lock() + defer { lock.unlock() } + return array.indices ~= index ? array[index] : nil + } + + set { + lock.lock() + defer { lock.unlock() } + if let newValue = newValue, array.indices ~= index { + array[index] = newValue + } + } + } + + var count : Int { + lock.lock() + defer { lock.unlock() } + return array.count + } + + func reserveCapacity(_ count: Int) { + lock.lock() + defer { lock.unlock() } + array.reserveCapacity(count) + } + + func append(_ element: Element) { + lock.lock() + defer { lock.unlock() } + array += [element] + } + + func removeAll() { + lock.lock() + defer { lock.unlock() } + array = [] + } +} +#endif +#endif diff --git a/Demo/Pods/Kingfisher/Sources/Views/Indicator.swift b/Demo/Pods/Kingfisher/Sources/Views/Indicator.swift new file mode 100644 index 0000000..a3fa5a4 --- /dev/null +++ b/Demo/Pods/Kingfisher/Sources/Views/Indicator.swift @@ -0,0 +1,231 @@ +// +// Indicator.swift +// Kingfisher +// +// Created by João D. Moreira on 30/08/16. +// +// Copyright (c) 2019 Wei Wang +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the "Software"), to deal +// in the Software without restriction, including without limitation the rights +// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +// copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +// THE SOFTWARE. + +#if !os(watchOS) + +#if canImport(AppKit) && !targetEnvironment(macCatalyst) +import AppKit +public typealias IndicatorView = NSView +#else +import UIKit +public typealias IndicatorView = UIView +#endif + +/// Represents the activity indicator type which should be added to +/// an image view when an image is being downloaded. +/// +/// - none: No indicator. +/// - activity: Uses the system activity indicator. +/// - image: Uses an image as indicator. GIF is supported. +/// - custom: Uses a custom indicator. The type of associated value should conform to the `Indicator` protocol. +public enum IndicatorType { + /// No indicator. + case none + /// Uses the system activity indicator. + case activity + /// Uses an image as indicator. GIF is supported. + case image(imageData: Data) + /// Uses a custom indicator. The type of associated value should conform to the `Indicator` protocol. + case custom(indicator: Indicator) +} + +/// An indicator type which can be used to show the download task is in progress. +public protocol Indicator { + + /// Called when the indicator should start animating. + func startAnimatingView() + + /// Called when the indicator should stop animating. + func stopAnimatingView() + + /// Center offset of the indicator. Kingfisher will use this value to determine the position of + /// indicator in the super view. + var centerOffset: CGPoint { get } + + /// The indicator view which would be added to the super view. + var view: IndicatorView { get } + + /// The size strategy used when adding the indicator to image view. + /// - Parameter imageView: The super view of indicator. + func sizeStrategy(in imageView: KFCrossPlatformImageView) -> IndicatorSizeStrategy +} + +public enum IndicatorSizeStrategy { + case intrinsicSize + case full + case size(CGSize) +} + +extension Indicator { + + /// Default implementation of `centerOffset` of `Indicator`. The default value is `.zero`, means that there is + /// no offset for the indicator view. + public var centerOffset: CGPoint { return .zero } + + /// Default implementation of `centerOffset` of `Indicator`. The default value is `.full`, means that the indicator + /// will pin to the same height and width as the image view. + public func sizeStrategy(in imageView: KFCrossPlatformImageView) -> IndicatorSizeStrategy { + return .full + } +} + +// Displays a NSProgressIndicator / UIActivityIndicatorView +final class ActivityIndicator: Indicator { + + #if os(macOS) + private let activityIndicatorView: NSProgressIndicator + #else + private let activityIndicatorView: UIActivityIndicatorView + #endif + private var animatingCount = 0 + + var view: IndicatorView { + return activityIndicatorView + } + + func startAnimatingView() { + if animatingCount == 0 { + #if os(macOS) + activityIndicatorView.startAnimation(nil) + #else + activityIndicatorView.startAnimating() + #endif + activityIndicatorView.isHidden = false + } + animatingCount += 1 + } + + func stopAnimatingView() { + animatingCount = max(animatingCount - 1, 0) + if animatingCount == 0 { + #if os(macOS) + activityIndicatorView.stopAnimation(nil) + #else + activityIndicatorView.stopAnimating() + #endif + activityIndicatorView.isHidden = true + } + } + + func sizeStrategy(in imageView: KFCrossPlatformImageView) -> IndicatorSizeStrategy { + return .intrinsicSize + } + + init() { + #if os(macOS) + activityIndicatorView = NSProgressIndicator(frame: CGRect(x: 0, y: 0, width: 16, height: 16)) + activityIndicatorView.controlSize = .small + activityIndicatorView.style = .spinning + #else + let indicatorStyle: UIActivityIndicatorView.Style + + #if os(tvOS) + if #available(tvOS 13.0, *) { + indicatorStyle = UIActivityIndicatorView.Style.large + } else { + indicatorStyle = UIActivityIndicatorView.Style.white + } + #else + if #available(iOS 13.0, * ) { + indicatorStyle = UIActivityIndicatorView.Style.medium + } else { + indicatorStyle = UIActivityIndicatorView.Style.gray + } + #endif + + activityIndicatorView = UIActivityIndicatorView(style: indicatorStyle) + #endif + } +} + +#if canImport(UIKit) +extension UIActivityIndicatorView.Style { + #if compiler(>=5.1) + #else + static let large = UIActivityIndicatorView.Style.white + #if !os(tvOS) + static let medium = UIActivityIndicatorView.Style.gray + #endif + #endif +} +#endif + +// MARK: - ImageIndicator +// Displays an ImageView. Supports gif +final class ImageIndicator: Indicator { + private let animatedImageIndicatorView: KFCrossPlatformImageView + + var view: IndicatorView { + return animatedImageIndicatorView + } + + init?( + imageData data: Data, + processor: ImageProcessor = DefaultImageProcessor.default, + options: KingfisherParsedOptionsInfo? = nil) + { + var options = options ?? KingfisherParsedOptionsInfo(nil) + // Use normal image view to show animations, so we need to preload all animation data. + if !options.preloadAllAnimationData { + options.preloadAllAnimationData = true + } + + guard let image = processor.process(item: .data(data), options: options) else { + return nil + } + + animatedImageIndicatorView = KFCrossPlatformImageView() + animatedImageIndicatorView.image = image + + #if os(macOS) + // Need for gif to animate on macOS + animatedImageIndicatorView.imageScaling = .scaleNone + animatedImageIndicatorView.canDrawSubviewsIntoLayer = true + #else + animatedImageIndicatorView.contentMode = .center + #endif + } + + func startAnimatingView() { + #if os(macOS) + animatedImageIndicatorView.animates = true + #else + animatedImageIndicatorView.startAnimating() + #endif + animatedImageIndicatorView.isHidden = false + } + + func stopAnimatingView() { + #if os(macOS) + animatedImageIndicatorView.animates = false + #else + animatedImageIndicatorView.stopAnimating() + #endif + animatedImageIndicatorView.isHidden = true + } +} + +#endif diff --git a/Demo/Pods/Manifest.lock b/Demo/Pods/Manifest.lock new file mode 100644 index 0000000..8a29c14 --- /dev/null +++ b/Demo/Pods/Manifest.lock @@ -0,0 +1,34 @@ +PODS: + - IGListDiffKit (4.0.0) + - IGListKit (4.0.0): + - IGListDiffKit (= 4.0.0) + - Kingfisher (7.6.2) + - SwiftMessages (9.0.6): + - SwiftMessages/App (= 9.0.6) + - SwiftMessages/App (9.0.6) + - UIColor_Hex_Swift (5.1.7) + +DEPENDENCIES: + - IGListKit + - Kingfisher (~> 7.6.2) + - SwiftMessages + - UIColor_Hex_Swift + +SPEC REPOS: + trunk: + - IGListDiffKit + - IGListKit + - Kingfisher + - SwiftMessages + - UIColor_Hex_Swift + +SPEC CHECKSUMS: + IGListDiffKit: 665d6cf43ce726e676013db9c7d6c4294259b6b2 + IGListKit: fd5a5d21935298f5849fa49d426843cff97b77c7 + Kingfisher: 6c5449c6450c5239166510ba04afe374a98afc4f + SwiftMessages: f0c7ef4705a570ad6c5e208b611f4333e660ed92 + UIColor_Hex_Swift: 31cd3e47440f07a20d2503a36bb0437a445b3c29 + +PODFILE CHECKSUM: 310645f0fa108e1099503961f2d58481962552ed + +COCOAPODS: 1.12.1 diff --git a/Demo/Pods/Pods.xcodeproj/project.pbxproj b/Demo/Pods/Pods.xcodeproj/project.pbxproj new file mode 100644 index 0000000..8ac5866 --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/project.pbxproj @@ -0,0 +1,2457 @@ +// !$*UTF8*$! +{ + archiveVersion = 1; + classes = { + }; + objectVersion = 56; + objects = { + +/* Begin PBXBuildFile section */ + 0052866F22FC243E2A20CC326BFF3F58 /* IGListSectionMap.h in Headers */ = {isa = PBXBuildFile; fileRef = 68248F05BB6436D9514BD865E5AEFD53 /* IGListSectionMap.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 00BEA6029C428FEE644AC3D42AD83282 /* ImagePrefetcher.swift in Sources */ = {isa = PBXBuildFile; fileRef = 18E261DDB018DEF41EF92A4794D0CC81 /* ImagePrefetcher.swift */; }; + 017FE38FF3607E56CABEF7C6F2D6D141 /* UIKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 007F365850B5C8A7EEA9E7F41F325B11 /* UIKit.framework */; }; + 0285857A24F66E925987A5876F0BE63B /* ImageDataProvider.swift in Sources */ = {isa = PBXBuildFile; fileRef = 19002AA8D6680BDDAC1C8C5DDE64CD49 /* ImageDataProvider.swift */; }; + 0510E8EA51914CB2176AD0F173937FAB /* KFImageRenderer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 225916A84FF5B787DDE7EB83441E3470 /* KFImageRenderer.swift */; }; + 05228565AAA7FCED4BAFB2B7EF71D53D /* KingfisherOptionsInfo.swift in Sources */ = {isa = PBXBuildFile; fileRef = D242674C42297EEEBD97DEE7B159B1AE /* KingfisherOptionsInfo.swift */; }; + 059639E700DEFAEF08F56484E5F67BE7 /* NSButton+Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = DEDF7F99C596705FC4F572460885EBCD /* NSButton+Kingfisher.swift */; }; + 05DF336E6DB67BB0621CCF0C9463ED4A /* IGListCollectionView.m in Sources */ = {isa = PBXBuildFile; fileRef = 7C7F743B6CB541B1A49D0F89CDE913C6 /* IGListCollectionView.m */; }; + 07ED65FC8B25E7420799D68D2CC59E7D /* IGListAdapterUpdateListener.h in Headers */ = {isa = PBXBuildFile; fileRef = 67EB0E60915C51E53FA40EB4CB81BAC9 /* IGListAdapterUpdateListener.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 08107140946FA9287B2C63728BFABB2E /* SwiftMessages-dummy.m in Sources */ = {isa = PBXBuildFile; fileRef = 25FFBB29D9878FEFD402D15B13F96F2F /* SwiftMessages-dummy.m */; }; + 082EDC820D76DF95C71A5018112DE512 /* UIButton+Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = AD245F26200BAD0F0C9385C5DEA429B7 /* UIButton+Kingfisher.swift */; }; + 08CA1A7B0A9F6B96CA4DFCFF977759CC /* errorIconLight.png in Resources */ = {isa = PBXBuildFile; fileRef = 8F8C5C6E34EBE4F7FEFFD3E815727A10 /* errorIconLight.png */; }; + 0ABF3498CC7F1EB2B3B3EA0648268D58 /* NSNumber+IGListDiffable.h in Headers */ = {isa = PBXBuildFile; fileRef = 51E9A430A8CB278156CC969E105579DA /* NSNumber+IGListDiffable.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 0B5893ABAF3F5EB6896FF6748BA24B9D /* IGListMoveIndexPath.m in Sources */ = {isa = PBXBuildFile; fileRef = 92CF5980D57F9F674AE272CB46916FF0 /* IGListMoveIndexPath.m */; }; + 0BC00DD25D3C4FF42C37433E81CA6F77 /* IGListCollectionViewLayout.mm in Sources */ = {isa = PBXBuildFile; fileRef = 8051E3132AD533F0FFDD835E592EBC46 /* IGListCollectionViewLayout.mm */; }; + 0C5AD6C37D168B6D4CEC37F24AEFEF9C /* UICollectionView+IGListBatchUpdateData.h in Headers */ = {isa = PBXBuildFile; fileRef = E8FA93108377D1E5B3A047566835F3D3 /* UICollectionView+IGListBatchUpdateData.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 0C5C1FCD4460D91B069B29E4E4267EBF /* UICollectionView+IGListBatchUpdateData.m in Sources */ = {isa = PBXBuildFile; fileRef = 4EB7D9E14485B011E821B2552487BFFF /* UICollectionView+IGListBatchUpdateData.m */; }; + 0CFD8E5542E0804B92A255670C94AB24 /* IGListDisplayDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = B6FCEA9D7060088104B1ACB5E98DC48F /* IGListDisplayDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 0D293ABB2BD3C45D748001FF3929AD4B /* IGListCollectionViewLayout.h in Headers */ = {isa = PBXBuildFile; fileRef = 4BC79CF900824AEA4ED4B584BE07F257 /* IGListCollectionViewLayout.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 0ED8FBFD9A86D21BF69137EC9350E575 /* SessionDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = D467CB3DCF65BE9C4B4067D5FFDD6859 /* SessionDelegate.swift */; }; + 0F9B2F409EF8A5AADE05FC337C4F4B20 /* IGListMoveIndexPath.h in Headers */ = {isa = PBXBuildFile; fileRef = DF5E502A140B8C7136E1F676C002042C /* IGListMoveIndexPath.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 106E77E6CCA0360F0EBCC653774E25F5 /* CardView.xib in Resources */ = {isa = PBXBuildFile; fileRef = 73660183B3F95FADC4C3F189620E5797 /* CardView.xib */; }; + 1185A2B40E14F2FCBC761FC99777CAD8 /* ExtensionHelpers.swift in Sources */ = {isa = PBXBuildFile; fileRef = AD155FF57E053DCC59222AD9E9006734 /* ExtensionHelpers.swift */; }; + 1199F40D641095A06DC44FA62F589282 /* IGListDebuggingUtilities.h in Headers */ = {isa = PBXBuildFile; fileRef = 6AD3632ED786F7D034F9E1A6EF5B3DAE /* IGListDebuggingUtilities.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 122980E44B15C64CF0B14DC94D7EB5C9 /* Kingfisher-umbrella.h in Headers */ = {isa = PBXBuildFile; fileRef = EE7F5B9CFE3D767F3DB305EE26C2283F /* Kingfisher-umbrella.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 12D9C86DE5B35895C8C4C2F66D98EF81 /* warningIconSubtle.png in Resources */ = {isa = PBXBuildFile; fileRef = 063A43A32CE98A3E1C417772EB31679E /* warningIconSubtle.png */; }; + 13786D2762D17C2F6715CA62D64AE76B /* infoIconSubtle@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 7288C4A89C8BEFB77574C7581276301B /* infoIconSubtle@3x.png */; }; + 137EF15CD62928D2E8C32B18E35CDA84 /* SwiftMessagesSegue.swift in Sources */ = {isa = PBXBuildFile; fileRef = 86D541130E17C7E352A8977E69E4D3DC /* SwiftMessagesSegue.swift */; }; + 145318846A4197187343A7223A8366BF /* IGListReloadDataUpdater.h in Headers */ = {isa = PBXBuildFile; fileRef = 8720FC3CB9A344DF6C3C51A81CE61E8F /* IGListReloadDataUpdater.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 194E2F707D9AE87266C08DDD38BAC2C5 /* UICollectionView+DebugDescription.m in Sources */ = {isa = PBXBuildFile; fileRef = 424235E351E1EEF73A585E53FCCE5931 /* UICollectionView+DebugDescription.m */; }; + 1952485AFF7A1BCCA4D4B142E82FE627 /* AnimatedImageView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 52372AE9D7E296FCED90D2D5BA9ECB4D /* AnimatedImageView.swift */; }; + 1A510118417546D747FA5B2DEE7D2009 /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */; }; + 1AA89F327105C026976BF6E831B193A2 /* ImageBinder.swift in Sources */ = {isa = PBXBuildFile; fileRef = FE009ADA0FD378470D467A226946D15F /* ImageBinder.swift */; }; + 1B17C9041C0794A94A39D5B31C62CEDE /* IGListDisplayHandler.m in Sources */ = {isa = PBXBuildFile; fileRef = 4E3CE7DF25AAEC00FF8F06896801111B /* IGListDisplayHandler.m */; }; + 1B2DDB8AD9504EB5AF857E4A45E3A979 /* NSString+IGListDiffable.h in Headers */ = {isa = PBXBuildFile; fileRef = EF2222773C495CA6BA87AAAA93B049B9 /* NSString+IGListDiffable.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 1BCE5E9382038062602EC3B882B0B1C1 /* errorIconLight@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 3B2A150E6AA79141831952D08C9CA44A /* errorIconLight@3x.png */; }; + 1D79FA4B26B801D9043A4BF8224939B9 /* UIKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 007F365850B5C8A7EEA9E7F41F325B11 /* UIKit.framework */; }; + 1EEBEB3E8E43888EFF440D810F4FE61F /* Weak.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6232B2401FA0928C2269BFD66C421986 /* Weak.swift */; }; + 1F727CB62A71B2ABE2CA4FBDC563A4A1 /* UIViewController+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = D9E43A922FEECF4031283D9C0CCEAD71 /* UIViewController+Extensions.swift */; }; + 1FD2928BC156D990D68B105F518C60B6 /* MemoryStorage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 92E5783214B75AAE3D5847FC4443333D /* MemoryStorage.swift */; }; + 1FE693B5ACC6AD7320CEFC20B64546E4 /* KingfisherManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 65601298C6B1A422CDB2DC07123D1E51 /* KingfisherManager.swift */; }; + 1FEE89BF952BE7ACA46E642DA2E48CA2 /* DiskStorage.swift in Sources */ = {isa = PBXBuildFile; fileRef = A99E6797E0FD83202E415971B87BC2AE /* DiskStorage.swift */; }; + 20A92FC736588CF2C5688AFD384EAD9D /* UIColorExtension.swift in Sources */ = {isa = PBXBuildFile; fileRef = A600EBFC4D5E663BCCFC8D3C2BEF24A6 /* UIColorExtension.swift */; }; + 21191DB3B6E3981B1D9682644743FF7E /* infoIcon@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 648D06A574C08D26489A675BF3F8CC97 /* infoIcon@3x.png */; }; + 22216C300C763044344B9DBF97317E63 /* RetryStrategy.swift in Sources */ = {isa = PBXBuildFile; fileRef = C401DDB5E824718372BEB559155F340E /* RetryStrategy.swift */; }; + 22BD1346F66BFCB129AAA44EEF322AC9 /* Resource.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4B0D3AE0230F985AC1ED5587C52B99DB /* Resource.swift */; }; + 243D7CFE1D56ED80ACB2B3E71B4CB603 /* AuthenticationChallengeResponsable.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8D5B3DE73BA8320B88507E03E2B50D19 /* AuthenticationChallengeResponsable.swift */; }; + 248A5D0758579F45393A48F7F1A816EE /* IGListAdapterDataSource.h in Headers */ = {isa = PBXBuildFile; fileRef = 27B420D1608AC6A991CAF82584A9805B /* IGListAdapterDataSource.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 256BA1F1360654F69778E29BBE25B04D /* IGListSupplementaryViewSource.h in Headers */ = {isa = PBXBuildFile; fileRef = B190AE5FF026FBD8339F4E3193D1A49E /* IGListSupplementaryViewSource.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 25FC036BEA33CAB5D80F5A41644535D3 /* Storage.swift in Sources */ = {isa = PBXBuildFile; fileRef = DA9BBA4DCEA951FBE5842187767A324A /* Storage.swift */; }; + 26A9A1D5029BDEB2C0AF0ECFE65ECBB6 /* BackgroundViewable.swift in Sources */ = {isa = PBXBuildFile; fileRef = F138F35B611E2FD49AEFCF69028D4AB7 /* BackgroundViewable.swift */; }; + 290CE4B2273A8DD7501C883649D798F4 /* IGListAdapterUpdater+DebugDescription.m in Sources */ = {isa = PBXBuildFile; fileRef = C8BFDA32ECAAAC6F60280C6BFAEAEE57 /* IGListAdapterUpdater+DebugDescription.m */; }; + 29A7C0BC88D85F89318C67E6293CFFB4 /* IGListBatchUpdates.h in Headers */ = {isa = PBXBuildFile; fileRef = BF7F03396FC5C7FFAB84FF05B036B970 /* IGListBatchUpdates.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 29A9E81F33421D1E32648B12D20B4F68 /* UIScrollView+IGListKit.h in Headers */ = {isa = PBXBuildFile; fileRef = 1351EB6B5E88098E59C3F20E89B2004C /* UIScrollView+IGListKit.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 29CE33F429B08D390973ADE3F05A097F /* warningIconLight@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 9A5FA7FE39BE7656FDDEB10178642B00 /* warningIconLight@3x.png */; }; + 29FF13E23FD52E46D30530549410AD7C /* ImageTransition.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0F789B805ED414860F2DC4C723AFE42D /* ImageTransition.swift */; }; + 2A44FC42DA4E309A6CD0C23845E62FDD /* MaskingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 01DFF373D32B02827C3E52EB2CD2A3FE /* MaskingView.swift */; }; + 2BE89C24BFD3FB663E37C607C289B3B6 /* RedirectHandler.swift in Sources */ = {isa = PBXBuildFile; fileRef = C107FC92873BF8C1318FB8BAB48B491D /* RedirectHandler.swift */; }; + 2CC46C11380D37A6DE73F58D4DEFF754 /* successIconLight.png in Resources */ = {isa = PBXBuildFile; fileRef = 17CAC30BEB11B3613D6C1DFA0950F7E9 /* successIconLight.png */; }; + 2CDD1385DB4E94B72AA923A2DB34D030 /* MarginAdjustable.swift in Sources */ = {isa = PBXBuildFile; fileRef = 09BA0051E9F4F47215585B6787C85C96 /* MarginAdjustable.swift */; }; + 2D2A77A53A45AA03F16F2411E6F7FEB7 /* IGListBatchUpdateData.h in Headers */ = {isa = PBXBuildFile; fileRef = C904783C0CEAE96552A679C695669DBC /* IGListBatchUpdateData.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 2D4F11BB21F21B0F1687BDA71200EB74 /* IGListIndexSetResultInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 07BC0E95B093644150AD1D0260560C1D /* IGListIndexSetResultInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 2D7DD1D4C822CE247530FAFBF36B41B4 /* successIcon@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = DC15D52D5B4A8353B7433818CFC755C3 /* successIcon@3x.png */; }; + 2EB12379C6E40E835D1AC08FAADFC392 /* UIColor_Hex_Swift-dummy.m in Sources */ = {isa = PBXBuildFile; fileRef = D5B77C4DD4EF76E7FC4D29F3BF7F1AAD /* UIColor_Hex_Swift-dummy.m */; }; + 2F0CA6E635295AA692FAEB9393783F4B /* IGListDebugger.m in Sources */ = {isa = PBXBuildFile; fileRef = 709704C7D88AAF115EDAB039595D266D /* IGListDebugger.m */; }; + 31D2A0320106459AC5D7A31F8C41646B /* IGListAdapter+UICollectionView.m in Sources */ = {isa = PBXBuildFile; fileRef = 39CF63638810AE1B4B6F37AF97A30C81 /* IGListAdapter+UICollectionView.m */; }; + 33634B64A37F709874AB14578331B98D /* Presenter.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4CDF76905EE491F6C6CEC1B70BC440D6 /* Presenter.swift */; }; + 36AA900737FE6B23825191A9011181DB /* MessageView.xib in Resources */ = {isa = PBXBuildFile; fileRef = CB4BCAA40F9050DCE2E7581EECE3B199 /* MessageView.xib */; }; + 37E2C53DDA53EE7696F3C78A095A70C2 /* IGListMoveIndexPathInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 996DBB5DDFA8515120D75647C8498AE8 /* IGListMoveIndexPathInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 395296368FAD6FEE70CE19FBCE22C316 /* IGListIndexPathResultInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = D2E866BD1073307B39C555AA72687DED /* IGListIndexPathResultInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 39A7FD94C1F455775CBBBC49131CDE98 /* successIcon.png in Resources */ = {isa = PBXBuildFile; fileRef = AED77699F9B880BBE2EA3CCA45FEE504 /* successIcon.png */; }; + 3A16D398DAB6AFE26767E5B5E9A37767 /* infoIcon@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 9833C8624EAC2FC205C021937F16B47D /* infoIcon@2x.png */; }; + 3AD5DBB915C2623991F7DBACD173BBB4 /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */; }; + 3AF7DB9AEFF47F1F7F91AF28440E4AC6 /* Filter.swift in Sources */ = {isa = PBXBuildFile; fileRef = A481C64506F5FE39DE63847F8959BE5D /* Filter.swift */; }; + 3DB2320AF24E5F4C92900577EE44878C /* UIColor_Hex_Swift-umbrella.h in Headers */ = {isa = PBXBuildFile; fileRef = A4F2B2BFBEFB50E3208CD5BC30F9573C /* UIColor_Hex_Swift-umbrella.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 3E9D03B9D56D435F1387EEE5B848D0C7 /* IGListBindable.h in Headers */ = {isa = PBXBuildFile; fileRef = BBE21E109176CA5683819D426970A5E5 /* IGListBindable.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 3EEE359E3EA05A87BEABA426D6092571 /* StringExtension.swift in Sources */ = {isa = PBXBuildFile; fileRef = CC2283864C5BFAC9FC50299F4F6071A9 /* StringExtension.swift */; }; + 3F2E1FB46259BAF163598529C1925BCB /* IGListBatchUpdates.m in Sources */ = {isa = PBXBuildFile; fileRef = B2DFA0063F8757E8167F805F39A2E3E1 /* IGListBatchUpdates.m */; }; + 3F69A921AA08DB133E702F3F7C395405 /* IGListIndexSetResultInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = DB6D5C8DD9281BFC32CE9E0A12F507D9 /* IGListIndexSetResultInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 404DCA74511EDA44B896202CD64458A0 /* errorIcon@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 6A7C4CC9232AC5706CBAB7721F33DE5B /* errorIcon@3x.png */; }; + 420C200A05BB29E1D299D1BADE9139D2 /* CFNetwork.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 7388592716E23DB7918BA1CEF956BA19 /* CFNetwork.framework */; }; + 456D4E89F94D07D831D2D06212DD3A21 /* IGListCollectionViewLayoutCompatible.h in Headers */ = {isa = PBXBuildFile; fileRef = F36F51D00377325A46E8AFB150E6113A /* IGListCollectionViewLayoutCompatible.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 457BE444ED617FA7D6851D6DAA9D7234 /* Delegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0C09F9726B03BEFB76DB54470EFA079E /* Delegate.swift */; }; + 4735A168EFDF0E56425C926BCEF42F33 /* IGListBindingSectionControllerSelectionDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = 30513773A49E99A4C75E6115DD8934EC /* IGListBindingSectionControllerSelectionDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 48065C2580FF9E5D2DE0E6447AACB110 /* errorIcon@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = AA5472E591CE0BA4D0BA9BD216E9BBB0 /* errorIcon@2x.png */; }; + 4A3FACE084B0154043BD4015B3E8FCC2 /* errorIconSubtle.png in Resources */ = {isa = PBXBuildFile; fileRef = 0E783AAB1D182A47CE9A4C70AEA15DC7 /* errorIconSubtle.png */; }; + 4AD71B305F0FFBCD1859562AA2F86A29 /* warningIconLight.png in Resources */ = {isa = PBXBuildFile; fileRef = 67E342B558FA9E3757D37EEB2E4D12A3 /* warningIconLight.png */; }; + 4B7802B665FAD2255F4A3D5FADE64B08 /* StatusLine.xib in Resources */ = {isa = PBXBuildFile; fileRef = C1B6942E8551B1ABFBEBCA492FA29A1F /* StatusLine.xib */; }; + 4B86DE37B3B553A574A54CCDDBC13680 /* IGListSectionController.h in Headers */ = {isa = PBXBuildFile; fileRef = F6ACCD5DC25939E8ED2EC86296E56DF6 /* IGListSectionController.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 4DCA9775E5CCF599460BDB46E77F6FA4 /* Kingfisher-dummy.m in Sources */ = {isa = PBXBuildFile; fileRef = 10FD14B174196E8692A3FF6CE273842B /* Kingfisher-dummy.m */; }; + 4E69250DFE230B7D9134B5360A91EC8D /* IGListDiffKit-umbrella.h in Headers */ = {isa = PBXBuildFile; fileRef = CC497F9013BFBD2093E1EC78B0273F64 /* IGListDiffKit-umbrella.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 4EE2EC2F10C2D2BC999CE30C679575FB /* HEXColor.h in Headers */ = {isa = PBXBuildFile; fileRef = 2F78D97A20A66B010C3E1ABDA41FFA5F /* HEXColor.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 4F37E521D341C47CE73DDCF21BA95A52 /* KingfisherError.swift in Sources */ = {isa = PBXBuildFile; fileRef = CF130AF5100D6FFE94E45CAEC5B8222E /* KingfisherError.swift */; }; + 4F7ADAB76F659FA15973E8EE2D390D36 /* UIKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 007F365850B5C8A7EEA9E7F41F325B11 /* UIKit.framework */; }; + 500C34AE9C3CBFFE6854C3627328C849 /* warningIconSubtle@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 2A7E3CFE0BA27926F6ABFC0513EF1282 /* warningIconSubtle@2x.png */; }; + 504FC6E2898BB2EAA2099072FBECB8B8 /* IGListAdapter+DebugDescription.h in Headers */ = {isa = PBXBuildFile; fileRef = B714F2FA5DE937147702D595D7104ACC /* IGListAdapter+DebugDescription.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 506128E1CC424E40E2691546D9547549 /* Placeholder.swift in Sources */ = {isa = PBXBuildFile; fileRef = 53BF7416BD4A970D1B5E4B01F294E586 /* Placeholder.swift */; }; + 509490FB1D30FEC59AE4BC21AEEBB7BB /* RequestModifier.swift in Sources */ = {isa = PBXBuildFile; fileRef = BB4552B30B4BEA7C253712647396FB87 /* RequestModifier.swift */; }; + 52800834B090075CA6F35EF7306B5AE5 /* CenteredView.xib in Resources */ = {isa = PBXBuildFile; fileRef = 1091A7C7D19C45920D87A3EAA1AA6C0F /* CenteredView.xib */; }; + 53526734412F401A087EC20F9A3CC7EB /* IGListMoveIndex.h in Headers */ = {isa = PBXBuildFile; fileRef = 896B6B102742772B634D79305645CA79 /* IGListMoveIndex.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 5456CE7488C7FE316C00605531107BFD /* IGListIndexPathResult.h in Headers */ = {isa = PBXBuildFile; fileRef = 4BED2EF6A3B24B9C0BF0E9524B7B6436 /* IGListIndexPathResult.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 5752BA2732399E70CFA4026649B32D3B /* IGListDiffKit-dummy.m in Sources */ = {isa = PBXBuildFile; fileRef = 2713DB42F5385245C2EC0D72720C5BE6 /* IGListDiffKit-dummy.m */; }; + 57FC31B14C753B5C63CEF00560F8A6EF /* SizeExtensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1F3E90B88F5618F4D313769ED312089B /* SizeExtensions.swift */; }; + 582D59E0D2EF62E0575933C99B393704 /* GraphicsContext.swift in Sources */ = {isa = PBXBuildFile; fileRef = 31363CA02DABFE037A9597E66D774E50 /* GraphicsContext.swift */; }; + 59BC9047F4BEBBC06235608D974E230D /* NSTextAttachment+Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = ED7503AECAE5B4ACEDDA8E6EF1740523 /* NSTextAttachment+Kingfisher.swift */; }; + 5ADB30DD9A03859018550A999ACB0652 /* KFImageOptions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 793410A19FBFCCE0BF378A5C8CF49BFA /* KFImageOptions.swift */; }; + 5C1B342A3F54657EEA7FC2105EF75523 /* IGListMoveIndexPathInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = D9CEFE6DEF6BE44242643753E89BE983 /* IGListMoveIndexPathInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 5E27DD292D3A55657712DD7AFA7B8FCA /* KFImage.swift in Sources */ = {isa = PBXBuildFile; fileRef = DF93862F9459B5B5101367844C76ACFC /* KFImage.swift */; }; + 5EBA64E274109B68134E970A1C831236 /* IGListCollectionScrollingTraits.h in Headers */ = {isa = PBXBuildFile; fileRef = 2A1E479F8F71FB71F3C62C8450C4DC84 /* IGListCollectionScrollingTraits.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 5F852F38CBC282496CCBE37C51324B2F /* ImageProgressive.swift in Sources */ = {isa = PBXBuildFile; fileRef = 9615C14A8AD14AEA71CE750A1DA1EDF8 /* ImageProgressive.swift */; }; + 61976AFFB89BE9B4FFCCE448B16B895D /* UICollectionView+DebugDescription.h in Headers */ = {isa = PBXBuildFile; fileRef = C1B7F17AB35439D95BB2D5B84B8FF273 /* UICollectionView+DebugDescription.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 627B24A21C799D9876E8EDA4C203EB5C /* IGListDisplayHandler.h in Headers */ = {isa = PBXBuildFile; fileRef = F007DFBDE1351AA0BB0A55C234B06A7E /* IGListDisplayHandler.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 6354E790FC26E29FFFAB6F298404FE52 /* TabView.xib in Resources */ = {isa = PBXBuildFile; fileRef = 34EC4406FF95B83EF37D06F08D66A633 /* TabView.xib */; }; + 637DFADEF4F664E6E6932F0E27472FD5 /* IGListDiffKit.h in Headers */ = {isa = PBXBuildFile; fileRef = E9EF2C50B2F9F3FC8C75CE92032462AA /* IGListDiffKit.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 645463E624115A42FE45DD945C41DB40 /* Theme.swift in Sources */ = {isa = PBXBuildFile; fileRef = 461E8E5C8D92714274A6A58953D195C9 /* Theme.swift */; }; + 653E4F4EE5A4AE7C8E2C2BD9BE9AD111 /* IGListBindingSectionController.h in Headers */ = {isa = PBXBuildFile; fileRef = 118EB5557B6BA57C54ECE70977225895 /* IGListBindingSectionController.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 69A39E2DCEE7140DF3654C581C401637 /* KeyboardTrackingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 54AF051AB7BCD460987153D0685F73B2 /* KeyboardTrackingView.swift */; }; + 6A3B187375746C0888E5CFCDD868FCCB /* IGListMacros.h in Headers */ = {isa = PBXBuildFile; fileRef = 51A70695551771573DC2AA2EBA4C1856 /* IGListMacros.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 6B60128BF181756B5A05576C6068566F /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */; }; + 6C4C53377507F9D77E67A19F3B0DAE69 /* Identifiable.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0E56A83EDE9F898293353CD761ED323A /* Identifiable.swift */; }; + 6D093916DC5318912596E0AD1AA26238 /* successIcon@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = CE29AFF1B5B06DB5F46307D8CA2F94A2 /* successIcon@2x.png */; }; + 6D3253DE7778CCCB009EFB375AA84800 /* UIScrollView+IGListKit.m in Sources */ = {isa = PBXBuildFile; fileRef = DB1BF169705DB0B275CE4D023A9F5097 /* UIScrollView+IGListKit.m */; }; + 6E3E76E4A7F77A3973EE6449CE275137 /* UICollectionViewLayout+InteractiveReordering.h in Headers */ = {isa = PBXBuildFile; fileRef = 8C74304E2D1E7F3E9241DE00AF3868A9 /* UICollectionViewLayout+InteractiveReordering.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 6E5BC0F0DF1D4D4C3A81A3B1ABEB2E52 /* SwiftMessages-SwiftMessages in Resources */ = {isa = PBXBuildFile; fileRef = 753DD909979478A0C1B33E0524504EF1 /* SwiftMessages-SwiftMessages */; }; + 70FEC06F54286257E1BA1ECA0C99198D /* Image.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3934169222833A8921F287D6737C3D94 /* Image.swift */; }; + 724DBA853B4874B96363B04EA98D4147 /* infoIconSubtle.png in Resources */ = {isa = PBXBuildFile; fileRef = 645A2EAB5E61532B3ABBCEBC6AF722C8 /* infoIconSubtle.png */; }; + 73448A3812B760B85DD6B64B85B49165 /* IGListTransitionDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = 3F4E7F4C4B0ED07AA5930C2E3D5B8FD6 /* IGListTransitionDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 73BC2BAEAFC76A79BF2A6E23CA54044F /* IGListCollectionViewLayoutInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 14D8F73E1EEE92B0BB6C4A4862D834A9 /* IGListCollectionViewLayoutInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 74021AE8DA8068962E566374E4097561 /* IGListBatchUpdateState.h in Headers */ = {isa = PBXBuildFile; fileRef = 0A2F39EF1CE1C157494607E6C1FE66A7 /* IGListBatchUpdateState.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 7448C55AC852D9DD05F91D03E7430E4C /* IGListScrollDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = 7ED99FCB6BB287CC3833E78421A0E4C1 /* IGListScrollDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 75240B35A5337C0362A81BA4E19C50A8 /* UIWindow+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8D3E03494034124977566245810EF836 /* UIWindow+Extensions.swift */; }; + 7597FD2790FC3E3002CC855FDF1EEFAB /* IGListArrayUtilsInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 77CDFE36E22AF91849D4D87D3DD75B16 /* IGListArrayUtilsInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 7598EFC472D8E80C444EAF66B3D53DDA /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */; }; + 760BE3F4C975ECE6B3AFDB55F66F0A78 /* UIKit.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 007F365850B5C8A7EEA9E7F41F325B11 /* UIKit.framework */; }; + 769764555AF9B0D77F7D1BDF6694A0F3 /* IGListDiff.h in Headers */ = {isa = PBXBuildFile; fileRef = 0495A674038D17605C95A9A5B9213100 /* IGListDiff.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 76E95598BA0A70C68E8782BC178A0B86 /* successIconLight@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 08510568CA8F1AEEDE5B0E32306DC71A /* successIconLight@3x.png */; }; + 770A7C634F7BBC9E2C030AAC217A383C /* IGListAdapterUpdaterInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 67AD88EDD5E2B4BE3251E36338822D75 /* IGListAdapterUpdaterInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 7947B831C0A0B1D6E01E862603BB6369 /* Animator.swift in Sources */ = {isa = PBXBuildFile; fileRef = 80AA6B070EDF3B36ED949C1DE413B445 /* Animator.swift */; }; + 7A5320B15F6789F272E61C44F9F4DBB0 /* SwiftMessages.Config+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 517254B0F9ADBAC88606A8124B700550 /* SwiftMessages.Config+Extensions.swift */; }; + 7BB3B41A692D42272CEB3CD6023A97B8 /* IGListIndexSetResult.m in Sources */ = {isa = PBXBuildFile; fileRef = F1D5521BDDA1A0242A36C1929596B475 /* IGListIndexSetResult.m */; }; + 7C7418FF01DD7BB909719682B634A8A5 /* SessionDataTask.swift in Sources */ = {isa = PBXBuildFile; fileRef = 9F5679710D252BC32A66875E79EE9BEB /* SessionDataTask.swift */; }; + 7CFC6E5C81DB4F42F1C469C8194FE64C /* IGListAdapterPerformanceDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = 111AD5BA834CFAE0B8CDB2B897047D06 /* IGListAdapterPerformanceDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 7D6EB166CD4530B9E1CB943798269D5B /* IGListIndexSetResult.h in Headers */ = {isa = PBXBuildFile; fileRef = 7AC803E40D56EEDCA7EE11F40F5D2873 /* IGListIndexSetResult.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 7E08A94F10299EADB052CAE34F2BFA00 /* TopBottomAnimation.swift in Sources */ = {isa = PBXBuildFile; fileRef = 49FFAA7BEFB9D929E25C31979D44D129 /* TopBottomAnimation.swift */; }; + 7E98E18B747F60326E4BA87E15839F29 /* UIEdgeInsets+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 9DD8DD2702C161767569A953B694435D /* UIEdgeInsets+Extensions.swift */; }; + 7FFE4021A4F14124342AD41CE1117B3E /* KFAnimatedImage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 9D034498F4799F076DA40C62E1C1CF6A /* KFAnimatedImage.swift */; }; + 80738D8956C9987CCCEDF551961E5069 /* ImageDataProcessor.swift in Sources */ = {isa = PBXBuildFile; fileRef = DEC751C1D0408841BADB8D95359DEDD0 /* ImageDataProcessor.swift */; }; + 80AF29D95B77B1DFCBF7F674954A8513 /* warningIconLight@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 635E1C7D580143C90A7C99F9B6145CC7 /* warningIconLight@2x.png */; }; + 82925050E10EBBC55386CBB189824F09 /* successIconSubtle@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 2987551134D451FC8A1024048B845790 /* successIconSubtle@2x.png */; }; + 83557F428BB0AF138061AD66390FAE57 /* errorIconSubtle@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = F1EB9AD47A886439B7A26D12430A76C1 /* errorIconSubtle@3x.png */; }; + 840F7452FC8C95F23BF04DD115213F2D /* IGListAdapter.h in Headers */ = {isa = PBXBuildFile; fileRef = F3A0944D15D667441A61E0CE8B2F5567 /* IGListAdapter.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 8500F9C0DFC843EB5A4ED4FF0664B213 /* IGListReloadDataUpdater.m in Sources */ = {isa = PBXBuildFile; fileRef = B0560DAEDE227C49E7CE1C22076E70AC /* IGListReloadDataUpdater.m */; }; + 857AB5F39FCA5E1F81A5D20A3A16DD19 /* IGListAdapterMoveDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = C3BAE6351018C0F1408D0BBB486AF803 /* IGListAdapterMoveDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 86A6370F297F87A34ABC316470B564C3 /* IGListReloadIndexPath.m in Sources */ = {isa = PBXBuildFile; fileRef = 6594CBDE5CC688CF8DBC51236163605D /* IGListReloadIndexPath.m */; }; + 881A35B28D93C56E46E305F6138B1A76 /* ImageDownloaderDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 2FFEB06874D80B62E4BA3E418B346091 /* ImageDownloaderDelegate.swift */; }; + 8933125F14AA552ACB4B02ACEAC95A46 /* IGListCollectionView.h in Headers */ = {isa = PBXBuildFile; fileRef = 9C2D15A0D67EAE136052527797313C80 /* IGListCollectionView.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 8A465CC2B4BB341735A5AEB15B28C587 /* IGListAdapterUpdater.m in Sources */ = {isa = PBXBuildFile; fileRef = 4D59E7CA06D24D19520DA2615F034822 /* IGListAdapterUpdater.m */; }; + 8AC9E9ACB2C52077863D538C75C1E430 /* IGListWorkingRangeDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = 8212866E5B322E817F4E1594B146D11E /* IGListWorkingRangeDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 8AF999CCB198F34068E9AC558864262D /* Error.swift in Sources */ = {isa = PBXBuildFile; fileRef = FBAC4E1C27713FF52E2D11B717422EC0 /* Error.swift */; }; + 8EF72BE56C31A8A67872154F61605B81 /* IGListExperiments.h in Headers */ = {isa = PBXBuildFile; fileRef = 759C0577310E0EFEB52904517125DCF7 /* IGListExperiments.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 8FB6113E9C4FFEB7A580060F3040B53C /* errorIconSubtle@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 4DB2CFEA6FDD21B6081185B3729B51D3 /* errorIconSubtle@2x.png */; }; + 92A554C6D0F616D62454C16FA59D8183 /* Pods-Bulletin-dummy.m in Sources */ = {isa = PBXBuildFile; fileRef = 98C5BC08D7F9EC2BBA718B8840AE0B46 /* Pods-Bulletin-dummy.m */; }; + 93149C816CBB4ED433D3A3EE6F5B9372 /* warningIcon.png in Resources */ = {isa = PBXBuildFile; fileRef = 1899BB102CCB03C961D392531F94109C /* warningIcon.png */; }; + 93427084C7854C572B84FF0C78CAD7C5 /* PassthroughWindow.swift in Sources */ = {isa = PBXBuildFile; fileRef = ABA9CF4FA93B0C6F6B68554063B72197 /* PassthroughWindow.swift */; }; + 94E07ACBB6D1F91A84009EE52CA247AD /* infoIconLight.png in Resources */ = {isa = PBXBuildFile; fileRef = 72EDEFFEFD9FA17167C3024ED8D81D74 /* infoIconLight.png */; }; + 96BA7BD41B99BCBE403CFC49DF217990 /* infoIconLight@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 7E32BABB4A5EC5D4E83FB5D95173A917 /* infoIconLight@3x.png */; }; + 983C97E8D8F2AA85CAEDDB6D74EBA866 /* IGListSectionMap.m in Sources */ = {isa = PBXBuildFile; fileRef = BD49496D6720223D5BD32660F3566682 /* IGListSectionMap.m */; }; + 9B0A78AC22E7EDA755F51D86527E2D9C /* Source.swift in Sources */ = {isa = PBXBuildFile; fileRef = 80E936467024EE1D60D40AF511570E73 /* Source.swift */; }; + 9BDCB75960A60DD0DEE0FA6101987B26 /* IGListAdapterUpdater+DebugDescription.h in Headers */ = {isa = PBXBuildFile; fileRef = D79BB4ADBD345BEC6C9D1C903BDEC902 /* IGListAdapterUpdater+DebugDescription.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 9C5254A71019F6D346E643611192AAF4 /* IGListCollectionViewDelegateLayout.h in Headers */ = {isa = PBXBuildFile; fileRef = 4A38804BDF6E084423F6ED17E2119797 /* IGListCollectionViewDelegateLayout.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 9CE4B00AD0EFD1C0A048270DA64986B2 /* IGListAdapter+UICollectionView.h in Headers */ = {isa = PBXBuildFile; fileRef = 5CF48A29FE13ED204720994FA4997255 /* IGListAdapter+UICollectionView.h */; settings = {ATTRIBUTES = (Private, ); }; }; + 9CFB36995618A21B72917C70D913E41A /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */; }; + 9E2B220A2A3223F08334BBCBDFEE5BC3 /* NSNumber+IGListDiffable.m in Sources */ = {isa = PBXBuildFile; fileRef = 4E92132F1FBCAEC55FD846EB03A29C5C /* NSNumber+IGListDiffable.m */; }; + 9ED0DFF2B7B21C647DDFC8559C9479C2 /* IGListAdapterUpdater.h in Headers */ = {isa = PBXBuildFile; fileRef = A558F0E26DB1E403F2BA4D285835649B /* IGListAdapterUpdater.h */; settings = {ATTRIBUTES = (Public, ); }; }; + 9F5FE22DA95B66B8DC21CB13BE25EC9B /* WKInterfaceImage+Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = A3B6D0D716E13A355BB46955460FFB80 /* WKInterfaceImage+Kingfisher.swift */; }; + 9F9F378DCF1582EBC63B23D9C8E2F238 /* successIconLight@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 9166C75ED413481507005F77A9BEE4AF /* successIconLight@2x.png */; }; + A0778F3A26137BE9262E2F4E042D04DF /* IGListIndexPathResultInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 526AFE8B2C5F857BB1C8ACF879C0ECCE /* IGListIndexPathResultInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + A122D2A3C925C48C11A200271047323E /* WindowViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = E8D88827F487BE149C1B8D4C8F21A887 /* WindowViewController.swift */; }; + A19366C6BC7101DC193D92176EB89C37 /* IGListKit-umbrella.h in Headers */ = {isa = PBXBuildFile; fileRef = E314F5C9EA1F8E0F93CB7A5863EF4352 /* IGListKit-umbrella.h */; settings = {ATTRIBUTES = (Public, ); }; }; + A1FFF4B8FB3410D63594007BBA288632 /* IGListReloadIndexPath.h in Headers */ = {isa = PBXBuildFile; fileRef = 72DAB1212901F5B52E7093E822D23577 /* IGListReloadIndexPath.h */; settings = {ATTRIBUTES = (Private, ); }; }; + A306349DCF43F00C535D8A7C2B5DDE55 /* IGListSectionMap+DebugDescription.h in Headers */ = {isa = PBXBuildFile; fileRef = A7228A433C789CABC0C81CB754A42B8B /* IGListSectionMap+DebugDescription.h */; settings = {ATTRIBUTES = (Private, ); }; }; + A316388A35648CB2987E761771456087 /* KFOptionsSetter.swift in Sources */ = {isa = PBXBuildFile; fileRef = B4FD74B7B2B30A494ADC03256687A532 /* KFOptionsSetter.swift */; }; + A39D3555EC8B45B7D6B9505DDAF0F117 /* Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = AEDF019A7D273CA293038AC2E7E27AF7 /* Kingfisher.swift */; }; + A404C0924ECF70F20F76E1AA5F32876D /* IGListDebugger.h in Headers */ = {isa = PBXBuildFile; fileRef = D8DBF71C0BE4BA02FEE918097192B2B7 /* IGListDebugger.h */; settings = {ATTRIBUTES = (Private, ); }; }; + A426AB76106748CDFB137114A6F63935 /* warningIcon@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 95A39432E536B69E1F62334D0007FAC2 /* warningIcon@3x.png */; }; + A55902F47A9DACFEAC7D0833A569911E /* CALayer+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = FA656E9DD3994DB5C569165361FFF7EE /* CALayer+Extensions.swift */; }; + A88A844D5356E1690E445024CB796E09 /* Result.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6688907CE0F1BF85B4A1ED07A4FD73BB /* Result.swift */; }; + A9CCA2DCDE1D1EA45BAD74C5CB3E9253 /* NSLayoutConstraint+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 912F4E96A8B3BB480A20592F7C6B709A /* NSLayoutConstraint+Extensions.swift */; }; + AB3D4BBA18DEA9DDCB82E15EE6DA80FE /* IGListDiffable.h in Headers */ = {isa = PBXBuildFile; fileRef = 03C406CF79037D94F19036ADEC84DAC7 /* IGListDiffable.h */; settings = {ATTRIBUTES = (Public, ); }; }; + ABAD2E2E0682AB7FF1C6213388E4EBA2 /* BaseView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 21A539BD413B6B92DD2DD6FBD9368394 /* BaseView.swift */; }; + AC348A3AA450BFA43A0B4869FB82772A /* SwiftMessages.swift in Sources */ = {isa = PBXBuildFile; fileRef = 6BEB7CE647AFB6BEE5DF438AE86B2F54 /* SwiftMessages.swift */; }; + AD707CFC669380B926AFB1FE7AE9B867 /* PhysicsAnimation.swift in Sources */ = {isa = PBXBuildFile; fileRef = 53D11C1A637638ADF43AE1EB8BD508A5 /* PhysicsAnimation.swift */; }; + AD951EA8C76B4AE7CFB4669804B8275B /* IGListBindingSectionControllerDataSource.h in Headers */ = {isa = PBXBuildFile; fileRef = AD580318635BBFC7B1A532C8F86EE9B8 /* IGListBindingSectionControllerDataSource.h */; settings = {ATTRIBUTES = (Public, ); }; }; + AEB007C7128575842880AD5559D2D5AC /* MessageView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 8452BF3EA61C1D6EC6A9DCAB1C65173D /* MessageView.swift */; }; + AFCAEA6F64C31BBCA51EDE0A22C971FF /* CornerRoundingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 321AEF56ADD9B574B8E97C6E37AE6C36 /* CornerRoundingView.swift */; }; + B1DAC65FFC831F6D51EAC90BD4B4D92D /* IGListWorkingRangeHandler.h in Headers */ = {isa = PBXBuildFile; fileRef = CFFD614E723A7CA1CF56C4F27C14BB2C /* IGListWorkingRangeHandler.h */; settings = {ATTRIBUTES = (Private, ); }; }; + B25E07EA645911443A38DA1E68166156 /* Box.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3BE8BFF931E90A8B8F751859A979D9FF /* Box.swift */; }; + B5E02A83F6C06F6D285E2EB1365A07BE /* IGListSectionController.m in Sources */ = {isa = PBXBuildFile; fileRef = FF11DBFDB6B6CF5A0D1EA3D416156A68 /* IGListSectionController.m */; }; + B707A3EC8581E09D0BA10908C235D401 /* IGListKit-dummy.m in Sources */ = {isa = PBXBuildFile; fileRef = CFAF508ECC19E5ED7EE57D68482D8B2D /* IGListKit-dummy.m */; }; + B7384B67D262049B7A3D9A5F44CF3AD8 /* successIconSubtle.png in Resources */ = {isa = PBXBuildFile; fileRef = DBE15455BF19E1F22DA0EA9923EDDD39 /* successIconSubtle.png */; }; + BB2B1C8268535C8BB056EB34B907FE16 /* WindowScene.swift in Sources */ = {isa = PBXBuildFile; fileRef = E947DADE1C4D71798D03004B57C09B12 /* WindowScene.swift */; }; + BC34CECDF734877FE9651B831504D3F2 /* infoIconLight@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 6AAB51521257D54CBB370D9F3D32C816 /* infoIconLight@2x.png */; }; + BD382E78580D295D10100678D4F66A76 /* String+MD5.swift in Sources */ = {isa = PBXBuildFile; fileRef = 37B13934C4541B84DCD0CE345BE17813 /* String+MD5.swift */; }; + BF8F8C64DB7DBEC09546AE2C68B1929B /* IGListSectionControllerInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = BFA65400774FF943C82530BA1C6FBFD5 /* IGListSectionControllerInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + BFAB4C4DAEFAAE316F3F7006D0E7F45B /* NSBundle+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = 98C6563DD55C21E71E4E2CCB99C78C95 /* NSBundle+Extensions.swift */; }; + C0BB4FD34FBDE2C9E8571DD42F56FDD3 /* IGListAdapterInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 7DAFB222C9BA9663B8F1E40709DBDCA6 /* IGListAdapterInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + C0E2F479332ED0297D2152651EEBBC32 /* IGListAdapter.m in Sources */ = {isa = PBXBuildFile; fileRef = 1DC6890537D77DABA2EDB7D0C82839D8 /* IGListAdapter.m */; }; + C111B17154D65AFC9862B663697D1C5C /* warningIcon@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = B1E88B937D987546110BF9126ADB22B0 /* warningIcon@2x.png */; }; + C3CE74410F050DCA5E2C8E1FF26A1125 /* IGListAdapter+DebugDescription.m in Sources */ = {isa = PBXBuildFile; fileRef = 9200674997CD712EE42F9FEF1B4F1D25 /* IGListAdapter+DebugDescription.m */; }; + C3F1FE6BB2F3E83DF225DB091D768ED3 /* IGListBatchContext.h in Headers */ = {isa = PBXBuildFile; fileRef = 23A7B6D2D0BE30FBDCFEFC0841849D05 /* IGListBatchContext.h */; settings = {ATTRIBUTES = (Public, ); }; }; + C5814CF9B5EB63D89CBE27EE2A19520A /* IGListGenericSectionController.m in Sources */ = {isa = PBXBuildFile; fileRef = 38C2E0D5356E1E9F90038322D59A5320 /* IGListGenericSectionController.m */; }; + C78B03AD94E9ADA8E4A492D852A4036D /* IGListBindingSectionController+DebugDescription.h in Headers */ = {isa = PBXBuildFile; fileRef = 6EAD7EC2840F995AE8ABAC9C2B4CF5EA /* IGListBindingSectionController+DebugDescription.h */; settings = {ATTRIBUTES = (Private, ); }; }; + C8E736F2681D5A47031328BE6DBAF0D6 /* IGListWorkingRangeHandler.mm in Sources */ = {isa = PBXBuildFile; fileRef = 05BF6B6F8ADAC5E7BC99DE8A118BF6B6 /* IGListWorkingRangeHandler.mm */; }; + C8ED20CFCDFF904961EA7D6FCFAD1AAF /* errorIcon.png in Resources */ = {isa = PBXBuildFile; fileRef = 5088061C5D0ECA51E28E1D5C9C05CDF2 /* errorIcon.png */; }; + CC2D622535AED6D39919BAAD8B55B828 /* IGListSectionMap+DebugDescription.m in Sources */ = {isa = PBXBuildFile; fileRef = 93DFC745DDF011893D575891F77993E4 /* IGListSectionMap+DebugDescription.m */; }; + CD7AC3E1C98EA54F7C05C36C52805220 /* CacheSerializer.swift in Sources */ = {isa = PBXBuildFile; fileRef = 92E3930B2051A71F0FD7F48F8E97C348 /* CacheSerializer.swift */; }; + D005E9A215793DD5E318F94052C45350 /* UIColorInputError.swift in Sources */ = {isa = PBXBuildFile; fileRef = BCCD5F85BBD560CCB2EB64FAB0B1F00B /* UIColorInputError.swift */; }; + D05EC2EA72C86F0F25AC384102DE7238 /* IGListDiff.mm in Sources */ = {isa = PBXBuildFile; fileRef = 974BF1702E4695985E60FBB45338A8A7 /* IGListDiff.mm */; }; + D0D540212AFD7154B4C9207A9E5C911A /* IGListKit.h in Headers */ = {isa = PBXBuildFile; fileRef = 6D1F660EA325793B882E173B84016B9B /* IGListKit.h */; settings = {ATTRIBUTES = (Public, ); }; }; + D1354255D2A30A71D2915BD7A0D10960 /* successIconSubtle@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = CFA306987494C26AB6494A2C70A32AE3 /* successIconSubtle@3x.png */; }; + D603AA58EF97D461A57B2B1BCB883868 /* AVAssetImageDataProvider.swift in Sources */ = {isa = PBXBuildFile; fileRef = 802CFB873BF930917357D60645A37371 /* AVAssetImageDataProvider.swift */; }; + D8332E09169A7A9D00E0398D4392DB70 /* IGListCollectionContext.h in Headers */ = {isa = PBXBuildFile; fileRef = CA7B91D095A2146E7CB26C435BB87D78 /* IGListCollectionContext.h */; settings = {ATTRIBUTES = (Public, ); }; }; + DA36BB36699075B706863F8E6462F524 /* IGListBatchUpdateData+DebugDescription.h in Headers */ = {isa = PBXBuildFile; fileRef = 37B5D75335F8694F04630AECE5892B47 /* IGListBatchUpdateData+DebugDescription.h */; settings = {ATTRIBUTES = (Private, ); }; }; + DA537286B85140EC0B108E803DFB545E /* IGListMoveIndex.m in Sources */ = {isa = PBXBuildFile; fileRef = 28E5CF6FD87B92B31A35248BCCC7BDBE /* IGListMoveIndex.m */; }; + DAFC6CE6321395CF4523DD66DADBB9BA /* ImageDrawing.swift in Sources */ = {isa = PBXBuildFile; fileRef = 24C3AE2697C2C777471A4F671EFB544B /* ImageDrawing.swift */; }; + DBB8088E14A2ADEDB1CD840BAC835267 /* CPListItem+Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = A653BDF17479F16550C74F6CE6EA62F6 /* CPListItem+Kingfisher.swift */; }; + DC576EBDA8822307BFAA01B1E07EB6B2 /* IGListSingleSectionController.m in Sources */ = {isa = PBXBuildFile; fileRef = 2050EB0365A402B74F479EC3044072B2 /* IGListSingleSectionController.m */; }; + DD46E684526BF2A6315775DEBCA54960 /* warningIconSubtle@3x.png in Resources */ = {isa = PBXBuildFile; fileRef = 01CD4B0B843A3B4A985651F253653952 /* warningIconSubtle@3x.png */; }; + DD72DC30CF19FFC81AB19CD0B074000D /* ImageDownloader.swift in Sources */ = {isa = PBXBuildFile; fileRef = DCD553D3612DC6CC76F894AF0823A794 /* ImageDownloader.swift */; }; + DD87BCC0696946A029E25B638BFB1971 /* AccessibleMessage.swift in Sources */ = {isa = PBXBuildFile; fileRef = D1F58388A6DDB3EF0B970B865F5EDB38 /* AccessibleMessage.swift */; }; + DDA74D6EBFE54AC3941181507F8060AB /* IGListDebuggingUtilities.m in Sources */ = {isa = PBXBuildFile; fileRef = AC0554DE66BE45142D0D9A060832228E /* IGListDebuggingUtilities.m */; }; + DE532EF7D50A9CF68587DAD4C1A02BD7 /* FormatIndicatedCacheSerializer.swift in Sources */ = {isa = PBXBuildFile; fileRef = EC56036E713E5F3E1D5CF743FB2E30CE /* FormatIndicatedCacheSerializer.swift */; }; + DF12FA0162AEB2360E9D896FFCE3D8FD /* IGListAdapterUpdaterDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = 21DAC60AD8416D4C4DC7ECBCA6C41E55 /* IGListAdapterUpdaterDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + DF4563832C19B8582C810BF502A5CA29 /* KF.swift in Sources */ = {isa = PBXBuildFile; fileRef = F0150DA8D834C8B8F37D02689D618EB7 /* KF.swift */; }; + DFCDE4638265B4CCD494ECA5D560DBEE /* Indicator.swift in Sources */ = {isa = PBXBuildFile; fileRef = FDB7B3024FA7207F2C442C4AB05907D7 /* Indicator.swift */; }; + E0B5B9AA33DBB50133BF1886B076688A /* IGListSingleSectionController.h in Headers */ = {isa = PBXBuildFile; fileRef = BB9D49792750AB8422232444B4D6E947 /* IGListSingleSectionController.h */; settings = {ATTRIBUTES = (Public, ); }; }; + E1128C6D632504B9D7AF99B3838D3DCC /* IGListAdapterProxy.h in Headers */ = {isa = PBXBuildFile; fileRef = 6A2524ADEFD63F868610552BEE2C047D /* IGListAdapterProxy.h */; settings = {ATTRIBUTES = (Private, ); }; }; + E290630326514476CA3D4651D3FB2C12 /* SwiftMessages-umbrella.h in Headers */ = {isa = PBXBuildFile; fileRef = 881690ABF91DF5E1AFB107C1A817B51D /* SwiftMessages-umbrella.h */; settings = {ATTRIBUTES = (Public, ); }; }; + E362C21CF43363A849410617D9B0A524 /* IGListBatchUpdateData.mm in Sources */ = {isa = PBXBuildFile; fileRef = 369EB2D2F32E873F3665AE2FB0A59DB9 /* IGListBatchUpdateData.mm */; }; + E4B7D3D7779F1394C8104CF3615EC223 /* IGListBatchUpdateData+DebugDescription.m in Sources */ = {isa = PBXBuildFile; fileRef = DF5C02A0D1A2BFFC1A6EE72656191F77 /* IGListBatchUpdateData+DebugDescription.m */; }; + E5B664771063F1A9A372519A8466860B /* ImageView+Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = 453ED79EFF2CFCB0BB28AAFB6728A746 /* ImageView+Kingfisher.swift */; }; + E5FEA90E76B8D19728AE8D30969EB744 /* IGListAdapterProxy.m in Sources */ = {isa = PBXBuildFile; fileRef = 35E7C9FAC1444B886148B40E4E03A10A /* IGListAdapterProxy.m */; }; + E6D6C7D5E458A05CC736C340F853E9F6 /* ImageFormat.swift in Sources */ = {isa = PBXBuildFile; fileRef = A88C71355EB0F8098D7C610310E5ADF9 /* ImageFormat.swift */; }; + E719A3B025B9DACE693130120BD9B927 /* Accelerate.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = EB56C884B7F74971F1D47C11641BD905 /* Accelerate.framework */; }; + E7E6D0A1C2F66770BE1A484A01B01A63 /* IGListAssert.h in Headers */ = {isa = PBXBuildFile; fileRef = 969EC8B144DCFDBB8D6B20563FD767D8 /* IGListAssert.h */; settings = {ATTRIBUTES = (Public, ); }; }; + EB11BE0DBFDA8DFB6DA4A0C9AA39DEAE /* IGListUpdatingDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = 36AA5F43CA08202B3651464A17D2DC8E /* IGListUpdatingDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + EBB32304E8DD4BA115454E0050D47DED /* Runtime.swift in Sources */ = {isa = PBXBuildFile; fileRef = EBDB16CE65088B7BAADD99ED81716273 /* Runtime.swift */; }; + ECFA80EB6B070B2B500F725449368B48 /* UICollectionViewLayout+InteractiveReordering.m in Sources */ = {isa = PBXBuildFile; fileRef = BF5FCF915C68DC413EF7C3DC3908EA10 /* UICollectionViewLayout+InteractiveReordering.m */; }; + ED0C8BA7560D7324587B353E0960479F /* ImageCache.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3579EDF0F2B23FDC5BD85C5B34DC0AD6 /* ImageCache.swift */; }; + EE2007369A32179A1540374E29C343AE /* MarginAdjustable+Extensions.swift in Sources */ = {isa = PBXBuildFile; fileRef = DB06B0638434865F6E2DA73FF648F3A6 /* MarginAdjustable+Extensions.swift */; }; + EE3740A3D6C42F3766288ED5BCB8B95D /* errorIconLight@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = 8079F476C78D97C2FAE6BD81EEBC744F /* errorIconLight@2x.png */; }; + EE402590604403A03F734B8AD641AAD9 /* IGListCompatibility.h in Headers */ = {isa = PBXBuildFile; fileRef = 15FF74DFD7DA6973B4D076F529572592 /* IGListCompatibility.h */; settings = {ATTRIBUTES = (Public, ); }; }; + EF73165F049DB4864538A394FFCBE874 /* PassthroughView.swift in Sources */ = {isa = PBXBuildFile; fileRef = E008BF5B47FEF861254F08D2F41B94E2 /* PassthroughView.swift */; }; + EF9C4588CDA85AED8BBCF77451B2A35B /* ImageProcessor.swift in Sources */ = {isa = PBXBuildFile; fileRef = 74DA03441BD1BDF74130264922D71B19 /* ImageProcessor.swift */; }; + F105D53A3A5A848EA428305ACF3FDBBB /* IGListBindingSectionController+DebugDescription.m in Sources */ = {isa = PBXBuildFile; fileRef = EB6036A78A4C36D50745E215A018095B /* IGListBindingSectionController+DebugDescription.m */; }; + F17B1F8F2B6580343025237455A29D61 /* TVMonogramView+Kingfisher.swift in Sources */ = {isa = PBXBuildFile; fileRef = 71985F3B3B4297E61C48A92C40B847D8 /* TVMonogramView+Kingfisher.swift */; }; + F209D62202BD5D087E33685E52308500 /* IGListIndexPathResult.m in Sources */ = {isa = PBXBuildFile; fileRef = E8101380E5E87B4F4EC6DDD9D53C9667 /* IGListIndexPathResult.m */; }; + F24021BDE9B42D604E3341CAD8E34759 /* GIFAnimatedImage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1D250E60DB977C9D0BFF53ABCA2A997C /* GIFAnimatedImage.swift */; }; + F28F7B608086B6126003F02D8F79D79F /* IGListAdapterDelegate.h in Headers */ = {isa = PBXBuildFile; fileRef = A3B9660742F1460FA534B5C6DD0333B8 /* IGListAdapterDelegate.h */; settings = {ATTRIBUTES = (Public, ); }; }; + F2DC134E310796CDE38903CADC436726 /* Pods-Bulletin-umbrella.h in Headers */ = {isa = PBXBuildFile; fileRef = AEA97C6B1B634B2233D0ABCD79202C8E /* Pods-Bulletin-umbrella.h */; settings = {ATTRIBUTES = (Public, ); }; }; + F4852EA1DC3E1F1F346402EAEFE1109F /* infoIcon.png in Resources */ = {isa = PBXBuildFile; fileRef = D6597118FC7A651AD1C1B8186C857884 /* infoIcon.png */; }; + F5414F8A5B40521D0E4AEEB28378CB49 /* ImageContext.swift in Sources */ = {isa = PBXBuildFile; fileRef = E69D9C2CA746D767CAFF47CD3F8F0BB8 /* ImageContext.swift */; }; + F54DE563418B1783D6EC491A0C3A05DB /* ImageModifier.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0C41EE63D598C9A869E2FAAF99E10B90 /* ImageModifier.swift */; }; + F5FC561E72803649ED1023E463AB9D17 /* IGListBindingSectionController.m in Sources */ = {isa = PBXBuildFile; fileRef = 3CD8D6758B3642D5415A451F5CB22167 /* IGListBindingSectionController.m */; }; + F6CA0DA52CCF6EB9B47B22196FA14E3E /* IGListGenericSectionController.h in Headers */ = {isa = PBXBuildFile; fileRef = 8578B293CF58ED79CF3BB15C593A1811 /* IGListGenericSectionController.h */; settings = {ATTRIBUTES = (Public, ); }; }; + F7EF7184D41C22A77D70A2AE233D4E53 /* IGListMoveIndexInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 5892D28E2B92F79C8909C1A4304EDE19 /* IGListMoveIndexInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + F9537B023E24AC4A724E301F7E372491 /* KFImageProtocol.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0662908419CF488E8FE10FE90D80D493 /* KFImageProtocol.swift */; }; + FA006B42B99DAF8263341881FD510FF9 /* PhysicsPanHandler.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1510A0DCF8427B970410D4A435FA3984 /* PhysicsPanHandler.swift */; }; + FB1227598B1A07A4E0FC9AEC4F60E144 /* Foundation.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */; }; + FC9E1CBF800DFB8FE8F0E29D1CB8EA1A /* IGListMoveIndexInternal.h in Headers */ = {isa = PBXBuildFile; fileRef = 308B9DAEAE417FCC8AB9D385110BAB88 /* IGListMoveIndexInternal.h */; settings = {ATTRIBUTES = (Private, ); }; }; + FF09824309346665E2F1F7F5A45FB10F /* CallbackQueue.swift in Sources */ = {isa = PBXBuildFile; fileRef = BCB4CB332EC3A05BBA96845240C3B5C9 /* CallbackQueue.swift */; }; + FF3EB79404B1F1AF27E7298F4DF62FA2 /* NSString+IGListDiffable.m in Sources */ = {isa = PBXBuildFile; fileRef = 588967168C815A5579F4C6C0A3ADF4CA /* NSString+IGListDiffable.m */; }; + FF467117653668E74E2DA504B3BC3547 /* infoIconSubtle@2x.png in Resources */ = {isa = PBXBuildFile; fileRef = D9B697009E9B2897D4182C96CC40388B /* infoIconSubtle@2x.png */; }; +/* End PBXBuildFile section */ + +/* Begin PBXContainerItemProxy section */ + 1B3792504F0EED9EE18F016548B44086 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = BFDFE7DC352907FC980B868725387E98 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 674FDCAB4D51E702521F4CD31807F659; + remoteInfo = IGListKit; + }; + 55802A5FB5EBEB01607325E334C83585 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = BFDFE7DC352907FC980B868725387E98 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 93789445511E3FEAB3D09A6F552EEE2D; + remoteInfo = "SwiftMessages-SwiftMessages"; + }; + 66837020B415409BD9EC27EC5943B9A9 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = BFDFE7DC352907FC980B868725387E98 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 2D07A05F514BF9C5434DAC907988C708; + remoteInfo = IGListDiffKit; + }; + 800A33BC263765E54E7FBE37BFEC3000 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = BFDFE7DC352907FC980B868725387E98 /* Project object */; + proxyType = 1; + remoteGlobalIDString = DAB613A18652334F6BFC5F27BADF515D; + remoteInfo = SwiftMessages; + }; + BD3BFF283976737AF4A31E0233395338 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = BFDFE7DC352907FC980B868725387E98 /* Project object */; + proxyType = 1; + remoteGlobalIDString = E8022D22FAA6690B5E1C379C1BCE1491; + remoteInfo = Kingfisher; + }; + BECFFC24423DFC78A02F544B59390655 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = BFDFE7DC352907FC980B868725387E98 /* Project object */; + proxyType = 1; + remoteGlobalIDString = 2D07A05F514BF9C5434DAC907988C708; + remoteInfo = IGListDiffKit; + }; + E2E98D973191FE598F2C7D4D813CDBD5 /* PBXContainerItemProxy */ = { + isa = PBXContainerItemProxy; + containerPortal = BFDFE7DC352907FC980B868725387E98 /* Project object */; + proxyType = 1; + remoteGlobalIDString = A0CA3B0841360687C00D0E48D3E4C1B9; + remoteInfo = UIColor_Hex_Swift; + }; +/* End PBXContainerItemProxy section */ + +/* Begin PBXFileReference section */ + 007F365850B5C8A7EEA9E7F41F325B11 /* UIKit.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = UIKit.framework; path = Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS14.0.sdk/System/Library/Frameworks/UIKit.framework; sourceTree = DEVELOPER_DIR; }; + 01CD4B0B843A3B4A985651F253653952 /* warningIconSubtle@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "warningIconSubtle@3x.png"; path = "SwiftMessages/Resources/warningIconSubtle@3x.png"; sourceTree = ""; }; + 01DFF373D32B02827C3E52EB2CD2A3FE /* MaskingView.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = MaskingView.swift; path = SwiftMessages/MaskingView.swift; sourceTree = ""; }; + 03C406CF79037D94F19036ADEC84DAC7 /* IGListDiffable.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListDiffable.h; path = Source/IGListDiffKit/IGListDiffable.h; sourceTree = ""; }; + 0495A674038D17605C95A9A5B9213100 /* IGListDiff.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListDiff.h; path = Source/IGListDiffKit/IGListDiff.h; sourceTree = ""; }; + 05BF6B6F8ADAC5E7BC99DE8A118BF6B6 /* IGListWorkingRangeHandler.mm */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.cpp.objcpp; name = IGListWorkingRangeHandler.mm; path = Source/IGListKit/Internal/IGListWorkingRangeHandler.mm; sourceTree = ""; }; + 063A43A32CE98A3E1C417772EB31679E /* warningIconSubtle.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = warningIconSubtle.png; path = SwiftMessages/Resources/warningIconSubtle.png; sourceTree = ""; }; + 0662908419CF488E8FE10FE90D80D493 /* KFImageProtocol.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KFImageProtocol.swift; path = Sources/SwiftUI/KFImageProtocol.swift; sourceTree = ""; }; + 07017C809FA0F80CF1A57230031F6028 /* UIColor_Hex_Swift.modulemap */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.module; path = UIColor_Hex_Swift.modulemap; sourceTree = ""; }; + 07BC0E95B093644150AD1D0260560C1D /* IGListIndexSetResultInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListIndexSetResultInternal.h; path = Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h; sourceTree = ""; }; + 08510568CA8F1AEEDE5B0E32306DC71A /* successIconLight@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "successIconLight@3x.png"; path = "SwiftMessages/Resources/successIconLight@3x.png"; sourceTree = ""; }; + 09BA0051E9F4F47215585B6787C85C96 /* MarginAdjustable.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = MarginAdjustable.swift; path = SwiftMessages/MarginAdjustable.swift; sourceTree = ""; }; + 0A2F39EF1CE1C157494607E6C1FE66A7 /* IGListBatchUpdateState.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBatchUpdateState.h; path = Source/IGListKit/Internal/IGListBatchUpdateState.h; sourceTree = ""; }; + 0C09F9726B03BEFB76DB54470EFA079E /* Delegate.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Delegate.swift; path = Sources/Utility/Delegate.swift; sourceTree = ""; }; + 0C41EE63D598C9A869E2FAAF99E10B90 /* ImageModifier.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageModifier.swift; path = Sources/Networking/ImageModifier.swift; sourceTree = ""; }; + 0E56A83EDE9F898293353CD761ED323A /* Identifiable.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Identifiable.swift; path = SwiftMessages/Identifiable.swift; sourceTree = ""; }; + 0E783AAB1D182A47CE9A4C70AEA15DC7 /* errorIconSubtle.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = errorIconSubtle.png; path = SwiftMessages/Resources/errorIconSubtle.png; sourceTree = ""; }; + 0F789B805ED414860F2DC4C723AFE42D /* ImageTransition.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageTransition.swift; path = Sources/Image/ImageTransition.swift; sourceTree = ""; }; + 0F78C89D7312191E330B806A85A69672 /* Kingfisher-Info.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "Kingfisher-Info.plist"; sourceTree = ""; }; + 1091A7C7D19C45920D87A3EAA1AA6C0F /* CenteredView.xib */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = file.xib; name = CenteredView.xib; path = SwiftMessages/Resources/CenteredView.xib; sourceTree = ""; }; + 10FD14B174196E8692A3FF6CE273842B /* Kingfisher-dummy.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; path = "Kingfisher-dummy.m"; sourceTree = ""; }; + 111AD5BA834CFAE0B8CDB2B897047D06 /* IGListAdapterPerformanceDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterPerformanceDelegate.h; path = Source/IGListKit/IGListAdapterPerformanceDelegate.h; sourceTree = ""; }; + 118EB5557B6BA57C54ECE70977225895 /* IGListBindingSectionController.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBindingSectionController.h; path = Source/IGListKit/IGListBindingSectionController.h; sourceTree = ""; }; + 1351EB6B5E88098E59C3F20E89B2004C /* UIScrollView+IGListKit.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "UIScrollView+IGListKit.h"; path = "Source/IGListKit/Internal/UIScrollView+IGListKit.h"; sourceTree = ""; }; + 14D8F73E1EEE92B0BB6C4A4862D834A9 /* IGListCollectionViewLayoutInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCollectionViewLayoutInternal.h; path = Source/IGListKit/Internal/IGListCollectionViewLayoutInternal.h; sourceTree = ""; }; + 1510A0DCF8427B970410D4A435FA3984 /* PhysicsPanHandler.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = PhysicsPanHandler.swift; path = SwiftMessages/PhysicsPanHandler.swift; sourceTree = ""; }; + 15FF74DFD7DA6973B4D076F529572592 /* IGListCompatibility.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCompatibility.h; path = Source/IGListDiffKit/IGListCompatibility.h; sourceTree = ""; }; + 17CAC30BEB11B3613D6C1DFA0950F7E9 /* successIconLight.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = successIconLight.png; path = SwiftMessages/Resources/successIconLight.png; sourceTree = ""; }; + 1899BB102CCB03C961D392531F94109C /* warningIcon.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = warningIcon.png; path = SwiftMessages/Resources/warningIcon.png; sourceTree = ""; }; + 18E261DDB018DEF41EF92A4794D0CC81 /* ImagePrefetcher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImagePrefetcher.swift; path = Sources/Networking/ImagePrefetcher.swift; sourceTree = ""; }; + 19002AA8D6680BDDAC1C8C5DDE64CD49 /* ImageDataProvider.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageDataProvider.swift; path = Sources/General/ImageSource/ImageDataProvider.swift; sourceTree = ""; }; + 195AD71F7938FEA988FDCC5B0A10FFDF /* IGListDiffKit */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; name = IGListDiffKit; path = IGListDiffKit.framework; sourceTree = BUILT_PRODUCTS_DIR; }; + 1B08200E58B617675FE96006778840FB /* IGListDiffKit.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = IGListDiffKit.release.xcconfig; sourceTree = ""; }; + 1CCB2C2A7F8FDEAB42ECE286206B4CF3 /* IGListKit-Info.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "IGListKit-Info.plist"; sourceTree = ""; }; + 1D250E60DB977C9D0BFF53ABCA2A997C /* GIFAnimatedImage.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = GIFAnimatedImage.swift; path = Sources/Image/GIFAnimatedImage.swift; sourceTree = ""; }; + 1DC6890537D77DABA2EDB7D0C82839D8 /* IGListAdapter.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListAdapter.m; path = Source/IGListKit/IGListAdapter.m; sourceTree = ""; }; + 1F3E90B88F5618F4D313769ED312089B /* SizeExtensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = SizeExtensions.swift; path = Sources/Utility/SizeExtensions.swift; sourceTree = ""; }; + 2050EB0365A402B74F479EC3044072B2 /* IGListSingleSectionController.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListSingleSectionController.m; path = Source/IGListKit/IGListSingleSectionController.m; sourceTree = ""; }; + 20F98B848D2BF72F16DA1BDACF869D1A /* Pods-Bulletin */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; name = "Pods-Bulletin"; path = Pods_Bulletin.framework; sourceTree = BUILT_PRODUCTS_DIR; }; + 21A539BD413B6B92DD2DD6FBD9368394 /* BaseView.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = BaseView.swift; path = SwiftMessages/BaseView.swift; sourceTree = ""; }; + 21DAC60AD8416D4C4DC7ECBCA6C41E55 /* IGListAdapterUpdaterDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterUpdaterDelegate.h; path = Source/IGListKit/IGListAdapterUpdaterDelegate.h; sourceTree = ""; }; + 225916A84FF5B787DDE7EB83441E3470 /* KFImageRenderer.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KFImageRenderer.swift; path = Sources/SwiftUI/KFImageRenderer.swift; sourceTree = ""; }; + 23A7B6D2D0BE30FBDCFEFC0841849D05 /* IGListBatchContext.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBatchContext.h; path = Source/IGListKit/IGListBatchContext.h; sourceTree = ""; }; + 24C3AE2697C2C777471A4F671EFB544B /* ImageDrawing.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageDrawing.swift; path = Sources/Image/ImageDrawing.swift; sourceTree = ""; }; + 25FFBB29D9878FEFD402D15B13F96F2F /* SwiftMessages-dummy.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; path = "SwiftMessages-dummy.m"; sourceTree = ""; }; + 2713DB42F5385245C2EC0D72720C5BE6 /* IGListDiffKit-dummy.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; path = "IGListDiffKit-dummy.m"; sourceTree = ""; }; + 27B420D1608AC6A991CAF82584A9805B /* IGListAdapterDataSource.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterDataSource.h; path = Source/IGListKit/IGListAdapterDataSource.h; sourceTree = ""; }; + 28E5CF6FD87B92B31A35248BCCC7BDBE /* IGListMoveIndex.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListMoveIndex.m; path = Source/IGListDiffKit/IGListMoveIndex.m; sourceTree = ""; }; + 2987551134D451FC8A1024048B845790 /* successIconSubtle@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "successIconSubtle@2x.png"; path = "SwiftMessages/Resources/successIconSubtle@2x.png"; sourceTree = ""; }; + 2A1E479F8F71FB71F3C62C8450C4DC84 /* IGListCollectionScrollingTraits.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCollectionScrollingTraits.h; path = Source/IGListKit/IGListCollectionScrollingTraits.h; sourceTree = ""; }; + 2A7E3CFE0BA27926F6ABFC0513EF1282 /* warningIconSubtle@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "warningIconSubtle@2x.png"; path = "SwiftMessages/Resources/warningIconSubtle@2x.png"; sourceTree = ""; }; + 2B50C6FFEC0097EFE6FB31764A42CAFA /* Pods-Bulletin-acknowledgements.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "Pods-Bulletin-acknowledgements.plist"; sourceTree = ""; }; + 2F78D97A20A66B010C3E1ABDA41FFA5F /* HEXColor.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = HEXColor.h; path = HEXColor/HEXColor.h; sourceTree = ""; }; + 2FA03600975416DCA7ED5BA333AC99DB /* Kingfisher-prefix.pch */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "Kingfisher-prefix.pch"; sourceTree = ""; }; + 2FFEB06874D80B62E4BA3E418B346091 /* ImageDownloaderDelegate.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageDownloaderDelegate.swift; path = Sources/Networking/ImageDownloaderDelegate.swift; sourceTree = ""; }; + 30513773A49E99A4C75E6115DD8934EC /* IGListBindingSectionControllerSelectionDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBindingSectionControllerSelectionDelegate.h; path = Source/IGListKit/IGListBindingSectionControllerSelectionDelegate.h; sourceTree = ""; }; + 308B9DAEAE417FCC8AB9D385110BAB88 /* IGListMoveIndexInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListMoveIndexInternal.h; path = Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h; sourceTree = ""; }; + 31363CA02DABFE037A9597E66D774E50 /* GraphicsContext.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = GraphicsContext.swift; path = Sources/Image/GraphicsContext.swift; sourceTree = ""; }; + 321AEF56ADD9B574B8E97C6E37AE6C36 /* CornerRoundingView.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = CornerRoundingView.swift; path = SwiftMessages/CornerRoundingView.swift; sourceTree = ""; }; + 34EC4406FF95B83EF37D06F08D66A633 /* TabView.xib */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = file.xib; name = TabView.xib; path = SwiftMessages/Resources/TabView.xib; sourceTree = ""; }; + 3579EDF0F2B23FDC5BD85C5B34DC0AD6 /* ImageCache.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageCache.swift; path = Sources/Cache/ImageCache.swift; sourceTree = ""; }; + 35E7C9FAC1444B886148B40E4E03A10A /* IGListAdapterProxy.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListAdapterProxy.m; path = Source/IGListKit/Internal/IGListAdapterProxy.m; sourceTree = ""; }; + 369EB2D2F32E873F3665AE2FB0A59DB9 /* IGListBatchUpdateData.mm */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.cpp.objcpp; name = IGListBatchUpdateData.mm; path = Source/IGListDiffKit/IGListBatchUpdateData.mm; sourceTree = ""; }; + 36AA5F43CA08202B3651464A17D2DC8E /* IGListUpdatingDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListUpdatingDelegate.h; path = Source/IGListKit/IGListUpdatingDelegate.h; sourceTree = ""; }; + 37B13934C4541B84DCD0CE345BE17813 /* String+MD5.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "String+MD5.swift"; path = "Sources/Utility/String+MD5.swift"; sourceTree = ""; }; + 37B5D75335F8694F04630AECE5892B47 /* IGListBatchUpdateData+DebugDescription.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "IGListBatchUpdateData+DebugDescription.h"; path = "Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.h"; sourceTree = ""; }; + 38C2E0D5356E1E9F90038322D59A5320 /* IGListGenericSectionController.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListGenericSectionController.m; path = Source/IGListKit/IGListGenericSectionController.m; sourceTree = ""; }; + 3934169222833A8921F287D6737C3D94 /* Image.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Image.swift; path = Sources/Image/Image.swift; sourceTree = ""; }; + 39CF63638810AE1B4B6F37AF97A30C81 /* IGListAdapter+UICollectionView.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "IGListAdapter+UICollectionView.m"; path = "Source/IGListKit/Internal/IGListAdapter+UICollectionView.m"; sourceTree = ""; }; + 3A977FC7DDB65D48636DAD282F3D1FB8 /* IGListKit-prefix.pch */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "IGListKit-prefix.pch"; sourceTree = ""; }; + 3B0A6054CE428C4606ABFE6CB328CD2A /* IGListDiffKit-prefix.pch */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "IGListDiffKit-prefix.pch"; sourceTree = ""; }; + 3B2A150E6AA79141831952D08C9CA44A /* errorIconLight@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "errorIconLight@3x.png"; path = "SwiftMessages/Resources/errorIconLight@3x.png"; sourceTree = ""; }; + 3BE8BFF931E90A8B8F751859A979D9FF /* Box.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Box.swift; path = Sources/Utility/Box.swift; sourceTree = ""; }; + 3CD8D6758B3642D5415A451F5CB22167 /* IGListBindingSectionController.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListBindingSectionController.m; path = Source/IGListKit/IGListBindingSectionController.m; sourceTree = ""; }; + 3F4E7F4C4B0ED07AA5930C2E3D5B8FD6 /* IGListTransitionDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListTransitionDelegate.h; path = Source/IGListKit/IGListTransitionDelegate.h; sourceTree = ""; }; + 424235E351E1EEF73A585E53FCCE5931 /* UICollectionView+DebugDescription.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "UICollectionView+DebugDescription.m"; path = "Source/IGListKit/Internal/UICollectionView+DebugDescription.m"; sourceTree = ""; }; + 453ED79EFF2CFCB0BB28AAFB6728A746 /* ImageView+Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "ImageView+Kingfisher.swift"; path = "Sources/Extensions/ImageView+Kingfisher.swift"; sourceTree = ""; }; + 461E8E5C8D92714274A6A58953D195C9 /* Theme.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Theme.swift; path = SwiftMessages/Theme.swift; sourceTree = ""; }; + 4824F23D80FF9070A5F8A452DB11EB9A /* SwiftMessages */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; name = SwiftMessages; path = SwiftMessages.framework; sourceTree = BUILT_PRODUCTS_DIR; }; + 4891D530CDAA004230740CADC793F34C /* UIColor_Hex_Swift-Info.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "UIColor_Hex_Swift-Info.plist"; sourceTree = ""; }; + 49FFAA7BEFB9D929E25C31979D44D129 /* TopBottomAnimation.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = TopBottomAnimation.swift; path = SwiftMessages/TopBottomAnimation.swift; sourceTree = ""; }; + 4A38804BDF6E084423F6ED17E2119797 /* IGListCollectionViewDelegateLayout.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCollectionViewDelegateLayout.h; path = Source/IGListKit/IGListCollectionViewDelegateLayout.h; sourceTree = ""; }; + 4B0D3AE0230F985AC1ED5587C52B99DB /* Resource.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Resource.swift; path = Sources/General/ImageSource/Resource.swift; sourceTree = ""; }; + 4BC79CF900824AEA4ED4B584BE07F257 /* IGListCollectionViewLayout.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCollectionViewLayout.h; path = Source/IGListKit/IGListCollectionViewLayout.h; sourceTree = ""; }; + 4BED2EF6A3B24B9C0BF0E9524B7B6436 /* IGListIndexPathResult.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListIndexPathResult.h; path = Source/IGListDiffKit/IGListIndexPathResult.h; sourceTree = ""; }; + 4CDF76905EE491F6C6CEC1B70BC440D6 /* Presenter.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Presenter.swift; path = SwiftMessages/Presenter.swift; sourceTree = ""; }; + 4D59E7CA06D24D19520DA2615F034822 /* IGListAdapterUpdater.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListAdapterUpdater.m; path = Source/IGListKit/IGListAdapterUpdater.m; sourceTree = ""; }; + 4DB2CFEA6FDD21B6081185B3729B51D3 /* errorIconSubtle@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "errorIconSubtle@2x.png"; path = "SwiftMessages/Resources/errorIconSubtle@2x.png"; sourceTree = ""; }; + 4E3CE7DF25AAEC00FF8F06896801111B /* IGListDisplayHandler.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListDisplayHandler.m; path = Source/IGListKit/Internal/IGListDisplayHandler.m; sourceTree = ""; }; + 4E92132F1FBCAEC55FD846EB03A29C5C /* NSNumber+IGListDiffable.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "NSNumber+IGListDiffable.m"; path = "Source/IGListDiffKit/NSNumber+IGListDiffable.m"; sourceTree = ""; }; + 4EB7D9E14485B011E821B2552487BFFF /* UICollectionView+IGListBatchUpdateData.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "UICollectionView+IGListBatchUpdateData.m"; path = "Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.m"; sourceTree = ""; }; + 5088061C5D0ECA51E28E1D5C9C05CDF2 /* errorIcon.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = errorIcon.png; path = SwiftMessages/Resources/errorIcon.png; sourceTree = ""; }; + 517254B0F9ADBAC88606A8124B700550 /* SwiftMessages.Config+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "SwiftMessages.Config+Extensions.swift"; path = "SwiftMessages/SwiftMessages.Config+Extensions.swift"; sourceTree = ""; }; + 51A70695551771573DC2AA2EBA4C1856 /* IGListMacros.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListMacros.h; path = Source/IGListDiffKit/IGListMacros.h; sourceTree = ""; }; + 51E9A430A8CB278156CC969E105579DA /* NSNumber+IGListDiffable.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "NSNumber+IGListDiffable.h"; path = "Source/IGListDiffKit/NSNumber+IGListDiffable.h"; sourceTree = ""; }; + 52372AE9D7E296FCED90D2D5BA9ECB4D /* AnimatedImageView.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = AnimatedImageView.swift; path = Sources/Views/AnimatedImageView.swift; sourceTree = ""; }; + 526AFE8B2C5F857BB1C8ACF879C0ECCE /* IGListIndexPathResultInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListIndexPathResultInternal.h; path = Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h; sourceTree = ""; }; + 53BF7416BD4A970D1B5E4B01F294E586 /* Placeholder.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Placeholder.swift; path = Sources/Image/Placeholder.swift; sourceTree = ""; }; + 53D11C1A637638ADF43AE1EB8BD508A5 /* PhysicsAnimation.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = PhysicsAnimation.swift; path = SwiftMessages/PhysicsAnimation.swift; sourceTree = ""; }; + 54AF051AB7BCD460987153D0685F73B2 /* KeyboardTrackingView.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KeyboardTrackingView.swift; path = SwiftMessages/KeyboardTrackingView.swift; sourceTree = ""; }; + 5637AD2FC80473D851AC233FF4B3B506 /* SwiftMessages-Info.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "SwiftMessages-Info.plist"; sourceTree = ""; }; + 588967168C815A5579F4C6C0A3ADF4CA /* NSString+IGListDiffable.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "NSString+IGListDiffable.m"; path = "Source/IGListDiffKit/NSString+IGListDiffable.m"; sourceTree = ""; }; + 5892D28E2B92F79C8909C1A4304EDE19 /* IGListMoveIndexInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListMoveIndexInternal.h; path = Source/IGListDiffKit/Internal/IGListMoveIndexInternal.h; sourceTree = ""; }; + 58FA08FD4595D3CA9B2AA81405DE2EFA /* UIColor_Hex_Swift.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = UIColor_Hex_Swift.framework; sourceTree = BUILT_PRODUCTS_DIR; }; + 5CF48A29FE13ED204720994FA4997255 /* IGListAdapter+UICollectionView.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "IGListAdapter+UICollectionView.h"; path = "Source/IGListKit/Internal/IGListAdapter+UICollectionView.h"; sourceTree = ""; }; + 6232B2401FA0928C2269BFD66C421986 /* Weak.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Weak.swift; path = SwiftMessages/Weak.swift; sourceTree = ""; }; + 635E1C7D580143C90A7C99F9B6145CC7 /* warningIconLight@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "warningIconLight@2x.png"; path = "SwiftMessages/Resources/warningIconLight@2x.png"; sourceTree = ""; }; + 645A2EAB5E61532B3ABBCEBC6AF722C8 /* infoIconSubtle.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = infoIconSubtle.png; path = SwiftMessages/Resources/infoIconSubtle.png; sourceTree = ""; }; + 648D06A574C08D26489A675BF3F8CC97 /* infoIcon@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "infoIcon@3x.png"; path = "SwiftMessages/Resources/infoIcon@3x.png"; sourceTree = ""; }; + 650F2EE29CA64B40F86449904824F62E /* UIColor_Hex_Swift.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = UIColor_Hex_Swift.debug.xcconfig; sourceTree = ""; }; + 65601298C6B1A422CDB2DC07123D1E51 /* KingfisherManager.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KingfisherManager.swift; path = Sources/General/KingfisherManager.swift; sourceTree = ""; }; + 6594CBDE5CC688CF8DBC51236163605D /* IGListReloadIndexPath.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListReloadIndexPath.m; path = Source/IGListKit/Internal/IGListReloadIndexPath.m; sourceTree = ""; }; + 65A2E0145D001B9CF4A7EAD17835A07F /* SwiftMessages.modulemap */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.module; path = SwiftMessages.modulemap; sourceTree = ""; }; + 6688907CE0F1BF85B4A1ED07A4FD73BB /* Result.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Result.swift; path = Sources/Utility/Result.swift; sourceTree = ""; }; + 67AD88EDD5E2B4BE3251E36338822D75 /* IGListAdapterUpdaterInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterUpdaterInternal.h; path = Source/IGListKit/Internal/IGListAdapterUpdaterInternal.h; sourceTree = ""; }; + 67E342B558FA9E3757D37EEB2E4D12A3 /* warningIconLight.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = warningIconLight.png; path = SwiftMessages/Resources/warningIconLight.png; sourceTree = ""; }; + 67EB0E60915C51E53FA40EB4CB81BAC9 /* IGListAdapterUpdateListener.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterUpdateListener.h; path = Source/IGListKit/IGListAdapterUpdateListener.h; sourceTree = ""; }; + 68248F05BB6436D9514BD865E5AEFD53 /* IGListSectionMap.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListSectionMap.h; path = Source/IGListKit/Internal/IGListSectionMap.h; sourceTree = ""; }; + 6A2524ADEFD63F868610552BEE2C047D /* IGListAdapterProxy.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterProxy.h; path = Source/IGListKit/Internal/IGListAdapterProxy.h; sourceTree = ""; }; + 6A7C4CC9232AC5706CBAB7721F33DE5B /* errorIcon@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "errorIcon@3x.png"; path = "SwiftMessages/Resources/errorIcon@3x.png"; sourceTree = ""; }; + 6AAB51521257D54CBB370D9F3D32C816 /* infoIconLight@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "infoIconLight@2x.png"; path = "SwiftMessages/Resources/infoIconLight@2x.png"; sourceTree = ""; }; + 6AD3632ED786F7D034F9E1A6EF5B3DAE /* IGListDebuggingUtilities.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListDebuggingUtilities.h; path = Source/IGListKit/Internal/IGListDebuggingUtilities.h; sourceTree = ""; }; + 6BEB7CE647AFB6BEE5DF438AE86B2F54 /* SwiftMessages.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = SwiftMessages.swift; path = SwiftMessages/SwiftMessages.swift; sourceTree = ""; }; + 6D1F660EA325793B882E173B84016B9B /* IGListKit.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListKit.h; path = Source/IGListKit/IGListKit.h; sourceTree = ""; }; + 6DEBD199402AB8F5B24357217344B70B /* Pods-Bulletin.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = "Pods-Bulletin.debug.xcconfig"; sourceTree = ""; }; + 6E32E82CDA2470BB9DD50373EE56E2EC /* Pods-Bulletin.modulemap */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.module; path = "Pods-Bulletin.modulemap"; sourceTree = ""; }; + 6EAD7EC2840F995AE8ABAC9C2B4CF5EA /* IGListBindingSectionController+DebugDescription.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "IGListBindingSectionController+DebugDescription.h"; path = "Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.h"; sourceTree = ""; }; + 709704C7D88AAF115EDAB039595D266D /* IGListDebugger.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListDebugger.m; path = Source/IGListKit/Internal/IGListDebugger.m; sourceTree = ""; }; + 71985F3B3B4297E61C48A92C40B847D8 /* TVMonogramView+Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "TVMonogramView+Kingfisher.swift"; path = "Sources/Extensions/TVMonogramView+Kingfisher.swift"; sourceTree = ""; }; + 7288C4A89C8BEFB77574C7581276301B /* infoIconSubtle@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "infoIconSubtle@3x.png"; path = "SwiftMessages/Resources/infoIconSubtle@3x.png"; sourceTree = ""; }; + 72DAB1212901F5B52E7093E822D23577 /* IGListReloadIndexPath.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListReloadIndexPath.h; path = Source/IGListKit/Internal/IGListReloadIndexPath.h; sourceTree = ""; }; + 72EDEFFEFD9FA17167C3024ED8D81D74 /* infoIconLight.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = infoIconLight.png; path = SwiftMessages/Resources/infoIconLight.png; sourceTree = ""; }; + 73660183B3F95FADC4C3F189620E5797 /* CardView.xib */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = file.xib; name = CardView.xib; path = SwiftMessages/Resources/CardView.xib; sourceTree = ""; }; + 7388592716E23DB7918BA1CEF956BA19 /* CFNetwork.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = CFNetwork.framework; path = Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS14.0.sdk/System/Library/Frameworks/CFNetwork.framework; sourceTree = DEVELOPER_DIR; }; + 74DA03441BD1BDF74130264922D71B19 /* ImageProcessor.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageProcessor.swift; path = Sources/Image/ImageProcessor.swift; sourceTree = ""; }; + 74F450974763BCC065DF7162314F180D /* IGListKit.modulemap */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.module; path = IGListKit.modulemap; sourceTree = ""; }; + 753DD909979478A0C1B33E0524504EF1 /* SwiftMessages-SwiftMessages */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; name = "SwiftMessages-SwiftMessages"; path = SwiftMessages.bundle; sourceTree = BUILT_PRODUCTS_DIR; }; + 759C0577310E0EFEB52904517125DCF7 /* IGListExperiments.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListExperiments.h; path = Source/IGListDiffKit/IGListExperiments.h; sourceTree = ""; }; + 77CDFE36E22AF91849D4D87D3DD75B16 /* IGListArrayUtilsInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListArrayUtilsInternal.h; path = Source/IGListKit/Internal/IGListArrayUtilsInternal.h; sourceTree = ""; }; + 793410A19FBFCCE0BF378A5C8CF49BFA /* KFImageOptions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KFImageOptions.swift; path = Sources/SwiftUI/KFImageOptions.swift; sourceTree = ""; }; + 7AC803E40D56EEDCA7EE11F40F5D2873 /* IGListIndexSetResult.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListIndexSetResult.h; path = Source/IGListDiffKit/IGListIndexSetResult.h; sourceTree = ""; }; + 7C7F743B6CB541B1A49D0F89CDE913C6 /* IGListCollectionView.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListCollectionView.m; path = Source/IGListKit/IGListCollectionView.m; sourceTree = ""; }; + 7CB626D861306564520283F74F854D64 /* Kingfisher.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = Kingfisher.debug.xcconfig; sourceTree = ""; }; + 7DAFB222C9BA9663B8F1E40709DBDCA6 /* IGListAdapterInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterInternal.h; path = Source/IGListKit/Internal/IGListAdapterInternal.h; sourceTree = ""; }; + 7DFA141F9E4B0E2D3D78DA1215079EE0 /* IGListKit.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = IGListKit.debug.xcconfig; sourceTree = ""; }; + 7E32BABB4A5EC5D4E83FB5D95173A917 /* infoIconLight@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "infoIconLight@3x.png"; path = "SwiftMessages/Resources/infoIconLight@3x.png"; sourceTree = ""; }; + 7ED99FCB6BB287CC3833E78421A0E4C1 /* IGListScrollDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListScrollDelegate.h; path = Source/IGListKit/IGListScrollDelegate.h; sourceTree = ""; }; + 802CFB873BF930917357D60645A37371 /* AVAssetImageDataProvider.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = AVAssetImageDataProvider.swift; path = Sources/General/ImageSource/AVAssetImageDataProvider.swift; sourceTree = ""; }; + 8051E3132AD533F0FFDD835E592EBC46 /* IGListCollectionViewLayout.mm */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.cpp.objcpp; name = IGListCollectionViewLayout.mm; path = Source/IGListKit/IGListCollectionViewLayout.mm; sourceTree = ""; }; + 8079F476C78D97C2FAE6BD81EEBC744F /* errorIconLight@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "errorIconLight@2x.png"; path = "SwiftMessages/Resources/errorIconLight@2x.png"; sourceTree = ""; }; + 80AA6B070EDF3B36ED949C1DE413B445 /* Animator.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Animator.swift; path = SwiftMessages/Animator.swift; sourceTree = ""; }; + 80E936467024EE1D60D40AF511570E73 /* Source.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Source.swift; path = Sources/General/ImageSource/Source.swift; sourceTree = ""; }; + 82030DF9E124050C32BD06D505EE5FED /* SwiftMessages-prefix.pch */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "SwiftMessages-prefix.pch"; sourceTree = ""; }; + 8212866E5B322E817F4E1594B146D11E /* IGListWorkingRangeDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListWorkingRangeDelegate.h; path = Source/IGListKit/IGListWorkingRangeDelegate.h; sourceTree = ""; }; + 841EA054CFC907C24018C45ADC5F3E63 /* Kingfisher.modulemap */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.module; path = Kingfisher.modulemap; sourceTree = ""; }; + 8452BF3EA61C1D6EC6A9DCAB1C65173D /* MessageView.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = MessageView.swift; path = SwiftMessages/MessageView.swift; sourceTree = ""; }; + 8578B293CF58ED79CF3BB15C593A1811 /* IGListGenericSectionController.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListGenericSectionController.h; path = Source/IGListKit/IGListGenericSectionController.h; sourceTree = ""; }; + 86D541130E17C7E352A8977E69E4D3DC /* SwiftMessagesSegue.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = SwiftMessagesSegue.swift; path = SwiftMessages/SwiftMessagesSegue.swift; sourceTree = ""; }; + 8720FC3CB9A344DF6C3C51A81CE61E8F /* IGListReloadDataUpdater.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListReloadDataUpdater.h; path = Source/IGListKit/IGListReloadDataUpdater.h; sourceTree = ""; }; + 881690ABF91DF5E1AFB107C1A817B51D /* SwiftMessages-umbrella.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "SwiftMessages-umbrella.h"; sourceTree = ""; }; + 896B6B102742772B634D79305645CA79 /* IGListMoveIndex.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListMoveIndex.h; path = Source/IGListDiffKit/IGListMoveIndex.h; sourceTree = ""; }; + 8A43FF2E5825C8BA65CB38432F0C25D4 /* Pods-Bulletin-acknowledgements.markdown */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text; path = "Pods-Bulletin-acknowledgements.markdown"; sourceTree = ""; }; + 8C74304E2D1E7F3E9241DE00AF3868A9 /* UICollectionViewLayout+InteractiveReordering.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "UICollectionViewLayout+InteractiveReordering.h"; path = "Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.h"; sourceTree = ""; }; + 8D3E03494034124977566245810EF836 /* UIWindow+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "UIWindow+Extensions.swift"; path = "SwiftMessages/UIWindow+Extensions.swift"; sourceTree = ""; }; + 8D5B3DE73BA8320B88507E03E2B50D19 /* AuthenticationChallengeResponsable.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = AuthenticationChallengeResponsable.swift; path = Sources/Networking/AuthenticationChallengeResponsable.swift; sourceTree = ""; }; + 8F8C5C6E34EBE4F7FEFFD3E815727A10 /* errorIconLight.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = errorIconLight.png; path = SwiftMessages/Resources/errorIconLight.png; sourceTree = ""; }; + 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Foundation.framework; path = Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS14.0.sdk/System/Library/Frameworks/Foundation.framework; sourceTree = DEVELOPER_DIR; }; + 912F4E96A8B3BB480A20592F7C6B709A /* NSLayoutConstraint+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "NSLayoutConstraint+Extensions.swift"; path = "SwiftMessages/NSLayoutConstraint+Extensions.swift"; sourceTree = ""; }; + 9166C75ED413481507005F77A9BEE4AF /* successIconLight@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "successIconLight@2x.png"; path = "SwiftMessages/Resources/successIconLight@2x.png"; sourceTree = ""; }; + 9200674997CD712EE42F9FEF1B4F1D25 /* IGListAdapter+DebugDescription.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "IGListAdapter+DebugDescription.m"; path = "Source/IGListKit/Internal/IGListAdapter+DebugDescription.m"; sourceTree = ""; }; + 92CF5980D57F9F674AE272CB46916FF0 /* IGListMoveIndexPath.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListMoveIndexPath.m; path = Source/IGListDiffKit/IGListMoveIndexPath.m; sourceTree = ""; }; + 92E3930B2051A71F0FD7F48F8E97C348 /* CacheSerializer.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = CacheSerializer.swift; path = Sources/Cache/CacheSerializer.swift; sourceTree = ""; }; + 92E5783214B75AAE3D5847FC4443333D /* MemoryStorage.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = MemoryStorage.swift; path = Sources/Cache/MemoryStorage.swift; sourceTree = ""; }; + 93DFC745DDF011893D575891F77993E4 /* IGListSectionMap+DebugDescription.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "IGListSectionMap+DebugDescription.m"; path = "Source/IGListKit/Internal/IGListSectionMap+DebugDescription.m"; sourceTree = ""; }; + 95A39432E536B69E1F62334D0007FAC2 /* warningIcon@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "warningIcon@3x.png"; path = "SwiftMessages/Resources/warningIcon@3x.png"; sourceTree = ""; }; + 9615C14A8AD14AEA71CE750A1DA1EDF8 /* ImageProgressive.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageProgressive.swift; path = Sources/Image/ImageProgressive.swift; sourceTree = ""; }; + 969EC8B144DCFDBB8D6B20563FD767D8 /* IGListAssert.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAssert.h; path = Source/IGListDiffKit/IGListAssert.h; sourceTree = ""; }; + 974BF1702E4695985E60FBB45338A8A7 /* IGListDiff.mm */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.cpp.objcpp; name = IGListDiff.mm; path = Source/IGListDiffKit/IGListDiff.mm; sourceTree = ""; }; + 9833C8624EAC2FC205C021937F16B47D /* infoIcon@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "infoIcon@2x.png"; path = "SwiftMessages/Resources/infoIcon@2x.png"; sourceTree = ""; }; + 98C5BC08D7F9EC2BBA718B8840AE0B46 /* Pods-Bulletin-dummy.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; path = "Pods-Bulletin-dummy.m"; sourceTree = ""; }; + 98C6563DD55C21E71E4E2CCB99C78C95 /* NSBundle+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "NSBundle+Extensions.swift"; path = "SwiftMessages/NSBundle+Extensions.swift"; sourceTree = ""; }; + 99059BAD6A5767A4A437BB9C36600D35 /* IGListDiffKit.modulemap */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.module; path = IGListDiffKit.modulemap; sourceTree = ""; }; + 990E9245247EA175C5B3F06E3FD3ABEF /* UIColor_Hex_Swift.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = UIColor_Hex_Swift.release.xcconfig; sourceTree = ""; }; + 996DBB5DDFA8515120D75647C8498AE8 /* IGListMoveIndexPathInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListMoveIndexPathInternal.h; path = Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h; sourceTree = ""; }; + 9A5FA7FE39BE7656FDDEB10178642B00 /* warningIconLight@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "warningIconLight@3x.png"; path = "SwiftMessages/Resources/warningIconLight@3x.png"; sourceTree = ""; }; + 9A8E96020846E6E688E867EE7770F849 /* IGListDiffKit-Info.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "IGListDiffKit-Info.plist"; sourceTree = ""; }; + 9AA30AE820EDB8A30CFA77ED3357C1E5 /* IGListKit.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = IGListKit.release.xcconfig; sourceTree = ""; }; + 9C2D15A0D67EAE136052527797313C80 /* IGListCollectionView.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCollectionView.h; path = Source/IGListKit/IGListCollectionView.h; sourceTree = ""; }; + 9D034498F4799F076DA40C62E1C1CF6A /* KFAnimatedImage.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KFAnimatedImage.swift; path = Sources/SwiftUI/KFAnimatedImage.swift; sourceTree = ""; }; + 9D940727FF8FB9C785EB98E56350EF41 /* Podfile */ = {isa = PBXFileReference; explicitFileType = text.script.ruby; includeInIndex = 1; indentWidth = 2; name = Podfile; path = ../Podfile; sourceTree = SOURCE_ROOT; tabWidth = 2; xcLanguageSpecificationIdentifier = xcode.lang.ruby; }; + 9DD8DD2702C161767569A953B694435D /* UIEdgeInsets+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "UIEdgeInsets+Extensions.swift"; path = "SwiftMessages/UIEdgeInsets+Extensions.swift"; sourceTree = ""; }; + 9E7573C529987F0DB86026FA9777B8C3 /* Pods-Bulletin.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = "Pods-Bulletin.release.xcconfig"; sourceTree = ""; }; + 9F5679710D252BC32A66875E79EE9BEB /* SessionDataTask.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = SessionDataTask.swift; path = Sources/Networking/SessionDataTask.swift; sourceTree = ""; }; + A1B692CB750B2228127BCE50696B349C /* SwiftMessages.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = SwiftMessages.release.xcconfig; sourceTree = ""; }; + A3B6D0D716E13A355BB46955460FFB80 /* WKInterfaceImage+Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "WKInterfaceImage+Kingfisher.swift"; path = "Sources/Extensions/WKInterfaceImage+Kingfisher.swift"; sourceTree = ""; }; + A3B9660742F1460FA534B5C6DD0333B8 /* IGListAdapterDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterDelegate.h; path = Source/IGListKit/IGListAdapterDelegate.h; sourceTree = ""; }; + A481C64506F5FE39DE63847F8959BE5D /* Filter.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Filter.swift; path = Sources/Image/Filter.swift; sourceTree = ""; }; + A4F2B2BFBEFB50E3208CD5BC30F9573C /* UIColor_Hex_Swift-umbrella.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "UIColor_Hex_Swift-umbrella.h"; sourceTree = ""; }; + A558F0E26DB1E403F2BA4D285835649B /* IGListAdapterUpdater.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterUpdater.h; path = Source/IGListKit/IGListAdapterUpdater.h; sourceTree = ""; }; + A600EBFC4D5E663BCCFC8D3C2BEF24A6 /* UIColorExtension.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = UIColorExtension.swift; path = HEXColor/UIColorExtension.swift; sourceTree = ""; }; + A653BDF17479F16550C74F6CE6EA62F6 /* CPListItem+Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "CPListItem+Kingfisher.swift"; path = "Sources/Extensions/CPListItem+Kingfisher.swift"; sourceTree = ""; }; + A7228A433C789CABC0C81CB754A42B8B /* IGListSectionMap+DebugDescription.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "IGListSectionMap+DebugDescription.h"; path = "Source/IGListKit/Internal/IGListSectionMap+DebugDescription.h"; sourceTree = ""; }; + A88C71355EB0F8098D7C610310E5ADF9 /* ImageFormat.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageFormat.swift; path = Sources/Image/ImageFormat.swift; sourceTree = ""; }; + A99E6797E0FD83202E415971B87BC2AE /* DiskStorage.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = DiskStorage.swift; path = Sources/Cache/DiskStorage.swift; sourceTree = ""; }; + AA5472E591CE0BA4D0BA9BD216E9BBB0 /* errorIcon@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "errorIcon@2x.png"; path = "SwiftMessages/Resources/errorIcon@2x.png"; sourceTree = ""; }; + ABA9CF4FA93B0C6F6B68554063B72197 /* PassthroughWindow.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = PassthroughWindow.swift; path = SwiftMessages/PassthroughWindow.swift; sourceTree = ""; }; + AC0554DE66BE45142D0D9A060832228E /* IGListDebuggingUtilities.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListDebuggingUtilities.m; path = Source/IGListKit/Internal/IGListDebuggingUtilities.m; sourceTree = ""; }; + AD155FF57E053DCC59222AD9E9006734 /* ExtensionHelpers.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ExtensionHelpers.swift; path = Sources/Utility/ExtensionHelpers.swift; sourceTree = ""; }; + AD245F26200BAD0F0C9385C5DEA429B7 /* UIButton+Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "UIButton+Kingfisher.swift"; path = "Sources/Extensions/UIButton+Kingfisher.swift"; sourceTree = ""; }; + AD580318635BBFC7B1A532C8F86EE9B8 /* IGListBindingSectionControllerDataSource.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBindingSectionControllerDataSource.h; path = Source/IGListKit/IGListBindingSectionControllerDataSource.h; sourceTree = ""; }; + AEA97C6B1B634B2233D0ABCD79202C8E /* Pods-Bulletin-umbrella.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "Pods-Bulletin-umbrella.h"; sourceTree = ""; }; + AED77699F9B880BBE2EA3CCA45FEE504 /* successIcon.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = successIcon.png; path = SwiftMessages/Resources/successIcon.png; sourceTree = ""; }; + AEDF019A7D273CA293038AC2E7E27AF7 /* Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Kingfisher.swift; path = Sources/General/Kingfisher.swift; sourceTree = ""; }; + B0560DAEDE227C49E7CE1C22076E70AC /* IGListReloadDataUpdater.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListReloadDataUpdater.m; path = Source/IGListKit/IGListReloadDataUpdater.m; sourceTree = ""; }; + B190AE5FF026FBD8339F4E3193D1A49E /* IGListSupplementaryViewSource.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListSupplementaryViewSource.h; path = Source/IGListKit/IGListSupplementaryViewSource.h; sourceTree = ""; }; + B1E88B937D987546110BF9126ADB22B0 /* warningIcon@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "warningIcon@2x.png"; path = "SwiftMessages/Resources/warningIcon@2x.png"; sourceTree = ""; }; + B2DFA0063F8757E8167F805F39A2E3E1 /* IGListBatchUpdates.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListBatchUpdates.m; path = Source/IGListKit/Internal/IGListBatchUpdates.m; sourceTree = ""; }; + B3C6C3E0B0FE2750FE588E0AFBA66D62 /* IGListKit */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; name = IGListKit; path = IGListKit.framework; sourceTree = BUILT_PRODUCTS_DIR; }; + B3D3E8CEA6EB6B2960A1895BBFF73681 /* IGListDiffKit.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = IGListDiffKit.debug.xcconfig; sourceTree = ""; }; + B4FD74B7B2B30A494ADC03256687A532 /* KFOptionsSetter.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KFOptionsSetter.swift; path = Sources/General/KFOptionsSetter.swift; sourceTree = ""; }; + B6FCEA9D7060088104B1ACB5E98DC48F /* IGListDisplayDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListDisplayDelegate.h; path = Source/IGListKit/IGListDisplayDelegate.h; sourceTree = ""; }; + B714F2FA5DE937147702D595D7104ACC /* IGListAdapter+DebugDescription.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "IGListAdapter+DebugDescription.h"; path = "Source/IGListKit/Internal/IGListAdapter+DebugDescription.h"; sourceTree = ""; }; + BB41663FC2E747F846E5C48FA4003730 /* ResourceBundle-SwiftMessages-SwiftMessages-Info.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "ResourceBundle-SwiftMessages-SwiftMessages-Info.plist"; sourceTree = ""; }; + BB4552B30B4BEA7C253712647396FB87 /* RequestModifier.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = RequestModifier.swift; path = Sources/Networking/RequestModifier.swift; sourceTree = ""; }; + BB9D49792750AB8422232444B4D6E947 /* IGListSingleSectionController.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListSingleSectionController.h; path = Source/IGListKit/IGListSingleSectionController.h; sourceTree = ""; }; + BBE21E109176CA5683819D426970A5E5 /* IGListBindable.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBindable.h; path = Source/IGListKit/IGListBindable.h; sourceTree = ""; }; + BCB4CB332EC3A05BBA96845240C3B5C9 /* CallbackQueue.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = CallbackQueue.swift; path = Sources/Utility/CallbackQueue.swift; sourceTree = ""; }; + BCCD5F85BBD560CCB2EB64FAB0B1F00B /* UIColorInputError.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = UIColorInputError.swift; path = HEXColor/UIColorInputError.swift; sourceTree = ""; }; + BD49496D6720223D5BD32660F3566682 /* IGListSectionMap.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListSectionMap.m; path = Source/IGListKit/Internal/IGListSectionMap.m; sourceTree = ""; }; + BF5FCF915C68DC413EF7C3DC3908EA10 /* UICollectionViewLayout+InteractiveReordering.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "UICollectionViewLayout+InteractiveReordering.m"; path = "Source/IGListKit/Internal/UICollectionViewLayout+InteractiveReordering.m"; sourceTree = ""; }; + BF7F03396FC5C7FFAB84FF05B036B970 /* IGListBatchUpdates.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBatchUpdates.h; path = Source/IGListKit/Internal/IGListBatchUpdates.h; sourceTree = ""; }; + BFA65400774FF943C82530BA1C6FBFD5 /* IGListSectionControllerInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListSectionControllerInternal.h; path = Source/IGListKit/Internal/IGListSectionControllerInternal.h; sourceTree = ""; }; + C107FC92873BF8C1318FB8BAB48B491D /* RedirectHandler.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = RedirectHandler.swift; path = Sources/Networking/RedirectHandler.swift; sourceTree = ""; }; + C1B6942E8551B1ABFBEBCA492FA29A1F /* StatusLine.xib */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = file.xib; name = StatusLine.xib; path = SwiftMessages/Resources/StatusLine.xib; sourceTree = ""; }; + C1B7F17AB35439D95BB2D5B84B8FF273 /* UICollectionView+DebugDescription.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "UICollectionView+DebugDescription.h"; path = "Source/IGListKit/Internal/UICollectionView+DebugDescription.h"; sourceTree = ""; }; + C3BAE6351018C0F1408D0BBB486AF803 /* IGListAdapterMoveDelegate.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapterMoveDelegate.h; path = Source/IGListKit/IGListAdapterMoveDelegate.h; sourceTree = ""; }; + C3F44C782D64D7EB20B61CE3844EBFAD /* Kingfisher */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; name = Kingfisher; path = Kingfisher.framework; sourceTree = BUILT_PRODUCTS_DIR; }; + C401DDB5E824718372BEB559155F340E /* RetryStrategy.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = RetryStrategy.swift; path = Sources/Networking/RetryStrategy.swift; sourceTree = ""; }; + C5C70AB815F6269A74BCA19F3C854C39 /* UIColor_Hex_Swift-prefix.pch */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "UIColor_Hex_Swift-prefix.pch"; sourceTree = ""; }; + C8BFDA32ECAAAC6F60280C6BFAEAEE57 /* IGListAdapterUpdater+DebugDescription.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "IGListAdapterUpdater+DebugDescription.m"; path = "Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.m"; sourceTree = ""; }; + C904783C0CEAE96552A679C695669DBC /* IGListBatchUpdateData.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListBatchUpdateData.h; path = Source/IGListDiffKit/IGListBatchUpdateData.h; sourceTree = ""; }; + CA7B91D095A2146E7CB26C435BB87D78 /* IGListCollectionContext.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCollectionContext.h; path = Source/IGListKit/IGListCollectionContext.h; sourceTree = ""; }; + CB4BCAA40F9050DCE2E7581EECE3B199 /* MessageView.xib */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = file.xib; name = MessageView.xib; path = SwiftMessages/Resources/MessageView.xib; sourceTree = ""; }; + CC2283864C5BFAC9FC50299F4F6071A9 /* StringExtension.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = StringExtension.swift; path = HEXColor/StringExtension.swift; sourceTree = ""; }; + CC497F9013BFBD2093E1EC78B0273F64 /* IGListDiffKit-umbrella.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "IGListDiffKit-umbrella.h"; sourceTree = ""; }; + CE29AFF1B5B06DB5F46307D8CA2F94A2 /* successIcon@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "successIcon@2x.png"; path = "SwiftMessages/Resources/successIcon@2x.png"; sourceTree = ""; }; + CF130AF5100D6FFE94E45CAEC5B8222E /* KingfisherError.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KingfisherError.swift; path = Sources/General/KingfisherError.swift; sourceTree = ""; }; + CFA306987494C26AB6494A2C70A32AE3 /* successIconSubtle@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "successIconSubtle@3x.png"; path = "SwiftMessages/Resources/successIconSubtle@3x.png"; sourceTree = ""; }; + CFAF508ECC19E5ED7EE57D68482D8B2D /* IGListKit-dummy.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; path = "IGListKit-dummy.m"; sourceTree = ""; }; + CFFD614E723A7CA1CF56C4F27C14BB2C /* IGListWorkingRangeHandler.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListWorkingRangeHandler.h; path = Source/IGListKit/Internal/IGListWorkingRangeHandler.h; sourceTree = ""; }; + D1F58388A6DDB3EF0B970B865F5EDB38 /* AccessibleMessage.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = AccessibleMessage.swift; path = SwiftMessages/AccessibleMessage.swift; sourceTree = ""; }; + D242674C42297EEEBD97DEE7B159B1AE /* KingfisherOptionsInfo.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KingfisherOptionsInfo.swift; path = Sources/General/KingfisherOptionsInfo.swift; sourceTree = ""; }; + D2E866BD1073307B39C555AA72687DED /* IGListIndexPathResultInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListIndexPathResultInternal.h; path = Source/IGListDiffKit/Internal/IGListIndexPathResultInternal.h; sourceTree = ""; }; + D2EC6A9540A860E7EDBF13CF404CB4B8 /* Kingfisher.release.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = Kingfisher.release.xcconfig; sourceTree = ""; }; + D467CB3DCF65BE9C4B4067D5FFDD6859 /* SessionDelegate.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = SessionDelegate.swift; path = Sources/Networking/SessionDelegate.swift; sourceTree = ""; }; + D5B77C4DD4EF76E7FC4D29F3BF7F1AAD /* UIColor_Hex_Swift-dummy.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; path = "UIColor_Hex_Swift-dummy.m"; sourceTree = ""; }; + D6597118FC7A651AD1C1B8186C857884 /* infoIcon.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = infoIcon.png; path = SwiftMessages/Resources/infoIcon.png; sourceTree = ""; }; + D79BB4ADBD345BEC6C9D1C903BDEC902 /* IGListAdapterUpdater+DebugDescription.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "IGListAdapterUpdater+DebugDescription.h"; path = "Source/IGListKit/Internal/IGListAdapterUpdater+DebugDescription.h"; sourceTree = ""; }; + D8DBF71C0BE4BA02FEE918097192B2B7 /* IGListDebugger.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListDebugger.h; path = Source/IGListKit/Internal/IGListDebugger.h; sourceTree = ""; }; + D9B697009E9B2897D4182C96CC40388B /* infoIconSubtle@2x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "infoIconSubtle@2x.png"; path = "SwiftMessages/Resources/infoIconSubtle@2x.png"; sourceTree = ""; }; + D9CEFE6DEF6BE44242643753E89BE983 /* IGListMoveIndexPathInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListMoveIndexPathInternal.h; path = Source/IGListDiffKit/Internal/IGListMoveIndexPathInternal.h; sourceTree = ""; }; + D9E43A922FEECF4031283D9C0CCEAD71 /* UIViewController+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "UIViewController+Extensions.swift"; path = "SwiftMessages/UIViewController+Extensions.swift"; sourceTree = ""; }; + DA9BBA4DCEA951FBE5842187767A324A /* Storage.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Storage.swift; path = Sources/Cache/Storage.swift; sourceTree = ""; }; + DB06B0638434865F6E2DA73FF648F3A6 /* MarginAdjustable+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "MarginAdjustable+Extensions.swift"; path = "SwiftMessages/MarginAdjustable+Extensions.swift"; sourceTree = ""; }; + DB1BF169705DB0B275CE4D023A9F5097 /* UIScrollView+IGListKit.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "UIScrollView+IGListKit.m"; path = "Source/IGListKit/Internal/UIScrollView+IGListKit.m"; sourceTree = ""; }; + DB6D5C8DD9281BFC32CE9E0A12F507D9 /* IGListIndexSetResultInternal.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListIndexSetResultInternal.h; path = Source/IGListDiffKit/Internal/IGListIndexSetResultInternal.h; sourceTree = ""; }; + DBE15455BF19E1F22DA0EA9923EDDD39 /* successIconSubtle.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = successIconSubtle.png; path = SwiftMessages/Resources/successIconSubtle.png; sourceTree = ""; }; + DC15D52D5B4A8353B7433818CFC755C3 /* successIcon@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "successIcon@3x.png"; path = "SwiftMessages/Resources/successIcon@3x.png"; sourceTree = ""; }; + DCD553D3612DC6CC76F894AF0823A794 /* ImageDownloader.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageDownloader.swift; path = Sources/Networking/ImageDownloader.swift; sourceTree = ""; }; + DEC751C1D0408841BADB8D95359DEDD0 /* ImageDataProcessor.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageDataProcessor.swift; path = Sources/Networking/ImageDataProcessor.swift; sourceTree = ""; }; + DEDF7F99C596705FC4F572460885EBCD /* NSButton+Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "NSButton+Kingfisher.swift"; path = "Sources/Extensions/NSButton+Kingfisher.swift"; sourceTree = ""; }; + DF5C02A0D1A2BFFC1A6EE72656191F77 /* IGListBatchUpdateData+DebugDescription.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "IGListBatchUpdateData+DebugDescription.m"; path = "Source/IGListKit/Internal/IGListBatchUpdateData+DebugDescription.m"; sourceTree = ""; }; + DF5E502A140B8C7136E1F676C002042C /* IGListMoveIndexPath.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListMoveIndexPath.h; path = Source/IGListDiffKit/IGListMoveIndexPath.h; sourceTree = ""; }; + DF93862F9459B5B5101367844C76ACFC /* KFImage.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KFImage.swift; path = Sources/SwiftUI/KFImage.swift; sourceTree = ""; }; + E008BF5B47FEF861254F08D2F41B94E2 /* PassthroughView.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = PassthroughView.swift; path = SwiftMessages/PassthroughView.swift; sourceTree = ""; }; + E314F5C9EA1F8E0F93CB7A5863EF4352 /* IGListKit-umbrella.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "IGListKit-umbrella.h"; sourceTree = ""; }; + E69D9C2CA746D767CAFF47CD3F8F0BB8 /* ImageContext.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageContext.swift; path = Sources/SwiftUI/ImageContext.swift; sourceTree = ""; }; + E8101380E5E87B4F4EC6DDD9D53C9667 /* IGListIndexPathResult.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListIndexPathResult.m; path = Source/IGListDiffKit/IGListIndexPathResult.m; sourceTree = ""; }; + E8D88827F487BE149C1B8D4C8F21A887 /* WindowViewController.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = WindowViewController.swift; path = SwiftMessages/WindowViewController.swift; sourceTree = ""; }; + E8FA93108377D1E5B3A047566835F3D3 /* UICollectionView+IGListBatchUpdateData.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "UICollectionView+IGListBatchUpdateData.h"; path = "Source/IGListKit/Internal/UICollectionView+IGListBatchUpdateData.h"; sourceTree = ""; }; + E947DADE1C4D71798D03004B57C09B12 /* WindowScene.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = WindowScene.swift; path = SwiftMessages/WindowScene.swift; sourceTree = ""; }; + E9EF2C50B2F9F3FC8C75CE92032462AA /* IGListDiffKit.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListDiffKit.h; path = Source/IGListDiffKit/IGListDiffKit.h; sourceTree = ""; }; + EA8581BAFB783450DFD66F8C53661FFC /* Pods-Bulletin-frameworks.sh */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.script.sh; path = "Pods-Bulletin-frameworks.sh"; sourceTree = ""; }; + EB56C884B7F74971F1D47C11641BD905 /* Accelerate.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Accelerate.framework; path = Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS14.0.sdk/System/Library/Frameworks/Accelerate.framework; sourceTree = DEVELOPER_DIR; }; + EB6036A78A4C36D50745E215A018095B /* IGListBindingSectionController+DebugDescription.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = "IGListBindingSectionController+DebugDescription.m"; path = "Source/IGListKit/Internal/IGListBindingSectionController+DebugDescription.m"; sourceTree = ""; }; + EBDB16CE65088B7BAADD99ED81716273 /* Runtime.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Runtime.swift; path = Sources/Utility/Runtime.swift; sourceTree = ""; }; + EC56036E713E5F3E1D5CF743FB2E30CE /* FormatIndicatedCacheSerializer.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = FormatIndicatedCacheSerializer.swift; path = Sources/Cache/FormatIndicatedCacheSerializer.swift; sourceTree = ""; }; + ED7503AECAE5B4ACEDDA8E6EF1740523 /* NSTextAttachment+Kingfisher.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "NSTextAttachment+Kingfisher.swift"; path = "Sources/Extensions/NSTextAttachment+Kingfisher.swift"; sourceTree = ""; }; + EE7F5B9CFE3D767F3DB305EE26C2283F /* Kingfisher-umbrella.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; path = "Kingfisher-umbrella.h"; sourceTree = ""; }; + EF2222773C495CA6BA87AAAA93B049B9 /* NSString+IGListDiffable.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = "NSString+IGListDiffable.h"; path = "Source/IGListDiffKit/NSString+IGListDiffable.h"; sourceTree = ""; }; + F007DFBDE1351AA0BB0A55C234B06A7E /* IGListDisplayHandler.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListDisplayHandler.h; path = Source/IGListKit/Internal/IGListDisplayHandler.h; sourceTree = ""; }; + F0150DA8D834C8B8F37D02689D618EB7 /* KF.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = KF.swift; path = Sources/General/KF.swift; sourceTree = ""; }; + F138F35B611E2FD49AEFCF69028D4AB7 /* BackgroundViewable.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = BackgroundViewable.swift; path = SwiftMessages/BackgroundViewable.swift; sourceTree = ""; }; + F1D5521BDDA1A0242A36C1929596B475 /* IGListIndexSetResult.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListIndexSetResult.m; path = Source/IGListDiffKit/IGListIndexSetResult.m; sourceTree = ""; }; + F1EB9AD47A886439B7A26D12430A76C1 /* errorIconSubtle@3x.png */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = image.png; name = "errorIconSubtle@3x.png"; path = "SwiftMessages/Resources/errorIconSubtle@3x.png"; sourceTree = ""; }; + F36F51D00377325A46E8AFB150E6113A /* IGListCollectionViewLayoutCompatible.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListCollectionViewLayoutCompatible.h; path = Source/IGListKit/IGListCollectionViewLayoutCompatible.h; sourceTree = ""; }; + F3A0944D15D667441A61E0CE8B2F5567 /* IGListAdapter.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListAdapter.h; path = Source/IGListKit/IGListAdapter.h; sourceTree = ""; }; + F6ACCD5DC25939E8ED2EC86296E56DF6 /* IGListSectionController.h */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.h; name = IGListSectionController.h; path = Source/IGListKit/IGListSectionController.h; sourceTree = ""; }; + F8AD99B18C90F7FD70633BE67798C357 /* Pods-Bulletin-Info.plist */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.plist.xml; path = "Pods-Bulletin-Info.plist"; sourceTree = ""; }; + FA656E9DD3994DB5C569165361FFF7EE /* CALayer+Extensions.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = "CALayer+Extensions.swift"; path = "SwiftMessages/CALayer+Extensions.swift"; sourceTree = ""; }; + FB85FA489CBC63454660B040F371269C /* SwiftMessages.debug.xcconfig */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = text.xcconfig; path = SwiftMessages.debug.xcconfig; sourceTree = ""; }; + FBAC4E1C27713FF52E2D11B717422EC0 /* Error.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Error.swift; path = SwiftMessages/Error.swift; sourceTree = ""; }; + FDB7B3024FA7207F2C442C4AB05907D7 /* Indicator.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = Indicator.swift; path = Sources/Views/Indicator.swift; sourceTree = ""; }; + FE009ADA0FD378470D467A226946D15F /* ImageBinder.swift */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.swift; name = ImageBinder.swift; path = Sources/SwiftUI/ImageBinder.swift; sourceTree = ""; }; + FF11DBFDB6B6CF5A0D1EA3D416156A68 /* IGListSectionController.m */ = {isa = PBXFileReference; includeInIndex = 1; lastKnownFileType = sourcecode.c.objc; name = IGListSectionController.m; path = Source/IGListKit/IGListSectionController.m; sourceTree = ""; }; +/* End PBXFileReference section */ + +/* Begin PBXFrameworksBuildPhase section */ + 0DC33FC81EEF5C13DC2B4EF85CA14F78 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + 7598EFC472D8E80C444EAF66B3D53DDA /* Foundation.framework in Frameworks */, + 017FE38FF3607E56CABEF7C6F2D6D141 /* UIKit.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 1590561D96F3E074FE469B04D8F764C8 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + 9CFB36995618A21B72917C70D913E41A /* Foundation.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 1E5F34F325312F632646732A454D6AD6 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + 6B60128BF181756B5A05576C6068566F /* Foundation.framework in Frameworks */, + 760BE3F4C975ECE6B3AFDB55F66F0A78 /* UIKit.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 524D0CCC1F888BC91F616D53B4C381E8 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 5C9B3C65E54998F5193CA304A90C9083 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + FB1227598B1A07A4E0FC9AEC4F60E144 /* Foundation.framework in Frameworks */, + 4F7ADAB76F659FA15973E8EE2D390D36 /* UIKit.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 81DB1665E1495609510BA493822E5A85 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + E719A3B025B9DACE693130120BD9B927 /* Accelerate.framework in Frameworks */, + 420C200A05BB29E1D299D1BADE9139D2 /* CFNetwork.framework in Frameworks */, + 3AD5DBB915C2623991F7DBACD173BBB4 /* Foundation.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + F7EC70ECA9F3248B43189E7C38690FA1 /* Frameworks */ = { + isa = PBXFrameworksBuildPhase; + buildActionMask = 2147483647; + files = ( + 1A510118417546D747FA5B2DEE7D2009 /* Foundation.framework in Frameworks */, + 1D79FA4B26B801D9043A4BF8224939B9 /* UIKit.framework in Frameworks */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXFrameworksBuildPhase section */ + +/* Begin PBXGroup section */ + 074A5B71721A1B3F50DB8082DDD11157 /* Pods-Bulletin */ = { + isa = PBXGroup; + children = ( + 6E32E82CDA2470BB9DD50373EE56E2EC /* Pods-Bulletin.modulemap */, + 8A43FF2E5825C8BA65CB38432F0C25D4 /* Pods-Bulletin-acknowledgements.markdown */, + 2B50C6FFEC0097EFE6FB31764A42CAFA /* Pods-Bulletin-acknowledgements.plist */, + 98C5BC08D7F9EC2BBA718B8840AE0B46 /* Pods-Bulletin-dummy.m */, + EA8581BAFB783450DFD66F8C53661FFC /* Pods-Bulletin-frameworks.sh */, + F8AD99B18C90F7FD70633BE67798C357 /* Pods-Bulletin-Info.plist */, + AEA97C6B1B634B2233D0ABCD79202C8E /* Pods-Bulletin-umbrella.h */, + 6DEBD199402AB8F5B24357217344B70B /* Pods-Bulletin.debug.xcconfig */, + 9E7573C529987F0DB86026FA9777B8C3 /* Pods-Bulletin.release.xcconfig */, + ); + name = "Pods-Bulletin"; + path = "Target Support Files/Pods-Bulletin"; + sourceTree = ""; + }; + 07FCA4F85284D25B675A378F88FBBA14 /* Pods */ = { + isa = PBXGroup; + children = ( + B2C6EA9410FBA4324564C77CB2431009 /* IGListDiffKit */, + 2445315595D50385AA52A93DFE93E57C /* IGListKit */, + 7E2B523FF180B21B1BF18B644669F2C6 /* Kingfisher */, + 8CC0F3343BEDDC8D0126C8DC722D0B81 /* SwiftMessages */, + 67587C3C2323DB96F9027E6F594C629F /* UIColor_Hex_Swift */, + ); + name = Pods; + sourceTree = ""; + }; + 0B70A837D1A951EBD07A8957B700F7CC /* Support Files */ = { + isa = PBXGroup; + children = ( + 74F450974763BCC065DF7162314F180D /* IGListKit.modulemap */, + CFAF508ECC19E5ED7EE57D68482D8B2D /* IGListKit-dummy.m */, + 1CCB2C2A7F8FDEAB42ECE286206B4CF3 /* IGListKit-Info.plist */, + 3A977FC7DDB65D48636DAD282F3D1FB8 /* IGListKit-prefix.pch */, + E314F5C9EA1F8E0F93CB7A5863EF4352 /* IGListKit-umbrella.h */, + 7DFA141F9E4B0E2D3D78DA1215079EE0 /* IGListKit.debug.xcconfig */, + 9AA30AE820EDB8A30CFA77ED3357C1E5 /* IGListKit.release.xcconfig */, + ); + name = "Support Files"; + path = "../Target Support Files/IGListKit"; + sourceTree = ""; + }; + 125B588671DF46336D0F8154F40DE542 /* Support Files */ = { + isa = PBXGroup; + children = ( + BB41663FC2E747F846E5C48FA4003730 /* ResourceBundle-SwiftMessages-SwiftMessages-Info.plist */, + 65A2E0145D001B9CF4A7EAD17835A07F /* SwiftMessages.modulemap */, + 25FFBB29D9878FEFD402D15B13F96F2F /* SwiftMessages-dummy.m */, + 5637AD2FC80473D851AC233FF4B3B506 /* SwiftMessages-Info.plist */, + 82030DF9E124050C32BD06D505EE5FED /* SwiftMessages-prefix.pch */, + 881690ABF91DF5E1AFB107C1A817B51D /* SwiftMessages-umbrella.h */, + FB85FA489CBC63454660B040F371269C /* SwiftMessages.debug.xcconfig */, + A1B692CB750B2228127BCE50696B349C /* SwiftMessages.release.xcconfig */, + ); + name = "Support Files"; + path = "../Target Support Files/SwiftMessages"; + sourceTree = ""; + }; + 189B53BB925CD0E96CFBEF2E63E4BDC3 /* App */ = { + isa = PBXGroup; + children = ( + D1F58388A6DDB3EF0B970B865F5EDB38 /* AccessibleMessage.swift */, + 80AA6B070EDF3B36ED949C1DE413B445 /* Animator.swift */, + F138F35B611E2FD49AEFCF69028D4AB7 /* BackgroundViewable.swift */, + 21A539BD413B6B92DD2DD6FBD9368394 /* BaseView.swift */, + FA656E9DD3994DB5C569165361FFF7EE /* CALayer+Extensions.swift */, + 321AEF56ADD9B574B8E97C6E37AE6C36 /* CornerRoundingView.swift */, + FBAC4E1C27713FF52E2D11B717422EC0 /* Error.swift */, + 0E56A83EDE9F898293353CD761ED323A /* Identifiable.swift */, + 54AF051AB7BCD460987153D0685F73B2 /* KeyboardTrackingView.swift */, + 09BA0051E9F4F47215585B6787C85C96 /* MarginAdjustable.swift */, + DB06B0638434865F6E2DA73FF648F3A6 /* MarginAdjustable+Extensions.swift */, + 01DFF373D32B02827C3E52EB2CD2A3FE /* MaskingView.swift */, + 8452BF3EA61C1D6EC6A9DCAB1C65173D /* MessageView.swift */, + 98C6563DD55C21E71E4E2CCB99C78C95 /* NSBundle+Extensions.swift */, + 912F4E96A8B3BB480A20592F7C6B709A /* NSLayoutConstraint+Extensions.swift */, + E008BF5B47FEF861254F08D2F41B94E2 /* PassthroughView.swift */, + ABA9CF4FA93B0C6F6B68554063B72197 /* PassthroughWindow.swift */, + 53D11C1A637638ADF43AE1EB8BD508A5 /* PhysicsAnimation.swift */, + 1510A0DCF8427B970410D4A435FA3984 /* PhysicsPanHandler.swift */, + 4CDF76905EE491F6C6CEC1B70BC440D6 /* Presenter.swift */, + 6BEB7CE647AFB6BEE5DF438AE86B2F54 /* SwiftMessages.swift */, + 517254B0F9ADBAC88606A8124B700550 /* SwiftMessages.Config+Extensions.swift */, + 86D541130E17C7E352A8977E69E4D3DC /* SwiftMessagesSegue.swift */, + 461E8E5C8D92714274A6A58953D195C9 /* Theme.swift */, + 49FFAA7BEFB9D929E25C31979D44D129 /* TopBottomAnimation.swift */, + 9DD8DD2702C161767569A953B694435D /* UIEdgeInsets+Extensions.swift */, + D9E43A922FEECF4031283D9C0CCEAD71 /* UIViewController+Extensions.swift */, + 8D3E03494034124977566245810EF836 /* UIWindow+Extensions.swift */, + 6232B2401FA0928C2269BFD66C421986 /* Weak.swift */, + E947DADE1C4D71798D03004B57C09B12 /* WindowScene.swift */, + E8D88827F487BE149C1B8D4C8F21A887 /* WindowViewController.swift */, + 6589DBA334F6FAD920F93C7C11F91996 /* Resources */, + ); + name = App; + sourceTree = ""; + }; + 2445315595D50385AA52A93DFE93E57C /* IGListKit */ = { + isa = PBXGroup; + children = ( + F3A0944D15D667441A61E0CE8B2F5567 /* IGListAdapter.h */, + 1DC6890537D77DABA2EDB7D0C82839D8 /* IGListAdapter.m */, + B714F2FA5DE937147702D595D7104ACC /* IGListAdapter+DebugDescription.h */, + 9200674997CD712EE42F9FEF1B4F1D25 /* IGListAdapter+DebugDescription.m */, + 5CF48A29FE13ED204720994FA4997255 /* IGListAdapter+UICollectionView.h */, + 39CF63638810AE1B4B6F37AF97A30C81 /* IGListAdapter+UICollectionView.m */, + 27B420D1608AC6A991CAF82584A9805B /* IGListAdapterDataSource.h */, + A3B9660742F1460FA534B5C6DD0333B8 /* IGListAdapterDelegate.h */, + 7DAFB222C9BA9663B8F1E40709DBDCA6 /* IGListAdapterInternal.h */, + C3BAE6351018C0F1408D0BBB486AF803 /* IGListAdapterMoveDelegate.h */, + 111AD5BA834CFAE0B8CDB2B897047D06 /* IGListAdapterPerformanceDelegate.h */, + 6A2524ADEFD63F868610552BEE2C047D /* IGListAdapterProxy.h */, + 35E7C9FAC1444B886148B40E4E03A10A /* IGListAdapterProxy.m */, + 67EB0E60915C51E53FA40EB4CB81BAC9 /* IGListAdapterUpdateListener.h */, + A558F0E26DB1E403F2BA4D285835649B /* IGListAdapterUpdater.h */, + 4D59E7CA06D24D19520DA2615F034822 /* IGListAdapterUpdater.m */, + D79BB4ADBD345BEC6C9D1C903BDEC902 /* IGListAdapterUpdater+DebugDescription.h */, + C8BFDA32ECAAAC6F60280C6BFAEAEE57 /* IGListAdapterUpdater+DebugDescription.m */, + 21DAC60AD8416D4C4DC7ECBCA6C41E55 /* IGListAdapterUpdaterDelegate.h */, + 67AD88EDD5E2B4BE3251E36338822D75 /* IGListAdapterUpdaterInternal.h */, + 77CDFE36E22AF91849D4D87D3DD75B16 /* IGListArrayUtilsInternal.h */, + 23A7B6D2D0BE30FBDCFEFC0841849D05 /* IGListBatchContext.h */, + 37B5D75335F8694F04630AECE5892B47 /* IGListBatchUpdateData+DebugDescription.h */, + DF5C02A0D1A2BFFC1A6EE72656191F77 /* IGListBatchUpdateData+DebugDescription.m */, + BF7F03396FC5C7FFAB84FF05B036B970 /* IGListBatchUpdates.h */, + B2DFA0063F8757E8167F805F39A2E3E1 /* IGListBatchUpdates.m */, + 0A2F39EF1CE1C157494607E6C1FE66A7 /* IGListBatchUpdateState.h */, + BBE21E109176CA5683819D426970A5E5 /* IGListBindable.h */, + 118EB5557B6BA57C54ECE70977225895 /* IGListBindingSectionController.h */, + 3CD8D6758B3642D5415A451F5CB22167 /* IGListBindingSectionController.m */, + 6EAD7EC2840F995AE8ABAC9C2B4CF5EA /* IGListBindingSectionController+DebugDescription.h */, + EB6036A78A4C36D50745E215A018095B /* IGListBindingSectionController+DebugDescription.m */, + AD580318635BBFC7B1A532C8F86EE9B8 /* IGListBindingSectionControllerDataSource.h */, + 30513773A49E99A4C75E6115DD8934EC /* IGListBindingSectionControllerSelectionDelegate.h */, + CA7B91D095A2146E7CB26C435BB87D78 /* IGListCollectionContext.h */, + 2A1E479F8F71FB71F3C62C8450C4DC84 /* IGListCollectionScrollingTraits.h */, + 9C2D15A0D67EAE136052527797313C80 /* IGListCollectionView.h */, + 7C7F743B6CB541B1A49D0F89CDE913C6 /* IGListCollectionView.m */, + 4A38804BDF6E084423F6ED17E2119797 /* IGListCollectionViewDelegateLayout.h */, + 4BC79CF900824AEA4ED4B584BE07F257 /* IGListCollectionViewLayout.h */, + 8051E3132AD533F0FFDD835E592EBC46 /* IGListCollectionViewLayout.mm */, + F36F51D00377325A46E8AFB150E6113A /* IGListCollectionViewLayoutCompatible.h */, + 14D8F73E1EEE92B0BB6C4A4862D834A9 /* IGListCollectionViewLayoutInternal.h */, + D8DBF71C0BE4BA02FEE918097192B2B7 /* IGListDebugger.h */, + 709704C7D88AAF115EDAB039595D266D /* IGListDebugger.m */, + 6AD3632ED786F7D034F9E1A6EF5B3DAE /* IGListDebuggingUtilities.h */, + AC0554DE66BE45142D0D9A060832228E /* IGListDebuggingUtilities.m */, + B6FCEA9D7060088104B1ACB5E98DC48F /* IGListDisplayDelegate.h */, + F007DFBDE1351AA0BB0A55C234B06A7E /* IGListDisplayHandler.h */, + 4E3CE7DF25AAEC00FF8F06896801111B /* IGListDisplayHandler.m */, + 8578B293CF58ED79CF3BB15C593A1811 /* IGListGenericSectionController.h */, + 38C2E0D5356E1E9F90038322D59A5320 /* IGListGenericSectionController.m */, + D2E866BD1073307B39C555AA72687DED /* IGListIndexPathResultInternal.h */, + DB6D5C8DD9281BFC32CE9E0A12F507D9 /* IGListIndexSetResultInternal.h */, + 6D1F660EA325793B882E173B84016B9B /* IGListKit.h */, + 5892D28E2B92F79C8909C1A4304EDE19 /* IGListMoveIndexInternal.h */, + D9CEFE6DEF6BE44242643753E89BE983 /* IGListMoveIndexPathInternal.h */, + 8720FC3CB9A344DF6C3C51A81CE61E8F /* IGListReloadDataUpdater.h */, + B0560DAEDE227C49E7CE1C22076E70AC /* IGListReloadDataUpdater.m */, + 72DAB1212901F5B52E7093E822D23577 /* IGListReloadIndexPath.h */, + 6594CBDE5CC688CF8DBC51236163605D /* IGListReloadIndexPath.m */, + 7ED99FCB6BB287CC3833E78421A0E4C1 /* IGListScrollDelegate.h */, + F6ACCD5DC25939E8ED2EC86296E56DF6 /* IGListSectionController.h */, + FF11DBFDB6B6CF5A0D1EA3D416156A68 /* IGListSectionController.m */, + BFA65400774FF943C82530BA1C6FBFD5 /* IGListSectionControllerInternal.h */, + 68248F05BB6436D9514BD865E5AEFD53 /* IGListSectionMap.h */, + BD49496D6720223D5BD32660F3566682 /* IGListSectionMap.m */, + A7228A433C789CABC0C81CB754A42B8B /* IGListSectionMap+DebugDescription.h */, + 93DFC745DDF011893D575891F77993E4 /* IGListSectionMap+DebugDescription.m */, + BB9D49792750AB8422232444B4D6E947 /* IGListSingleSectionController.h */, + 2050EB0365A402B74F479EC3044072B2 /* IGListSingleSectionController.m */, + B190AE5FF026FBD8339F4E3193D1A49E /* IGListSupplementaryViewSource.h */, + 3F4E7F4C4B0ED07AA5930C2E3D5B8FD6 /* IGListTransitionDelegate.h */, + 36AA5F43CA08202B3651464A17D2DC8E /* IGListUpdatingDelegate.h */, + 8212866E5B322E817F4E1594B146D11E /* IGListWorkingRangeDelegate.h */, + CFFD614E723A7CA1CF56C4F27C14BB2C /* IGListWorkingRangeHandler.h */, + 05BF6B6F8ADAC5E7BC99DE8A118BF6B6 /* IGListWorkingRangeHandler.mm */, + C1B7F17AB35439D95BB2D5B84B8FF273 /* UICollectionView+DebugDescription.h */, + 424235E351E1EEF73A585E53FCCE5931 /* UICollectionView+DebugDescription.m */, + E8FA93108377D1E5B3A047566835F3D3 /* UICollectionView+IGListBatchUpdateData.h */, + 4EB7D9E14485B011E821B2552487BFFF /* UICollectionView+IGListBatchUpdateData.m */, + 8C74304E2D1E7F3E9241DE00AF3868A9 /* UICollectionViewLayout+InteractiveReordering.h */, + BF5FCF915C68DC413EF7C3DC3908EA10 /* UICollectionViewLayout+InteractiveReordering.m */, + 1351EB6B5E88098E59C3F20E89B2004C /* UIScrollView+IGListKit.h */, + DB1BF169705DB0B275CE4D023A9F5097 /* UIScrollView+IGListKit.m */, + 0B70A837D1A951EBD07A8957B700F7CC /* Support Files */, + ); + path = IGListKit; + sourceTree = ""; + }; + 43CF91C12C3F2936102F46DA4F2C7C75 /* Support Files */ = { + isa = PBXGroup; + children = ( + 99059BAD6A5767A4A437BB9C36600D35 /* IGListDiffKit.modulemap */, + 2713DB42F5385245C2EC0D72720C5BE6 /* IGListDiffKit-dummy.m */, + 9A8E96020846E6E688E867EE7770F849 /* IGListDiffKit-Info.plist */, + 3B0A6054CE428C4606ABFE6CB328CD2A /* IGListDiffKit-prefix.pch */, + CC497F9013BFBD2093E1EC78B0273F64 /* IGListDiffKit-umbrella.h */, + B3D3E8CEA6EB6B2960A1895BBFF73681 /* IGListDiffKit.debug.xcconfig */, + 1B08200E58B617675FE96006778840FB /* IGListDiffKit.release.xcconfig */, + ); + name = "Support Files"; + path = "../Target Support Files/IGListDiffKit"; + sourceTree = ""; + }; + 59123D44247562C173720EDD7EDC3E88 /* Support Files */ = { + isa = PBXGroup; + children = ( + 07017C809FA0F80CF1A57230031F6028 /* UIColor_Hex_Swift.modulemap */, + D5B77C4DD4EF76E7FC4D29F3BF7F1AAD /* UIColor_Hex_Swift-dummy.m */, + 4891D530CDAA004230740CADC793F34C /* UIColor_Hex_Swift-Info.plist */, + C5C70AB815F6269A74BCA19F3C854C39 /* UIColor_Hex_Swift-prefix.pch */, + A4F2B2BFBEFB50E3208CD5BC30F9573C /* UIColor_Hex_Swift-umbrella.h */, + 650F2EE29CA64B40F86449904824F62E /* UIColor_Hex_Swift.debug.xcconfig */, + 990E9245247EA175C5B3F06E3FD3ABEF /* UIColor_Hex_Swift.release.xcconfig */, + ); + name = "Support Files"; + path = "../Target Support Files/UIColor_Hex_Swift"; + sourceTree = ""; + }; + 6589DBA334F6FAD920F93C7C11F91996 /* Resources */ = { + isa = PBXGroup; + children = ( + 73660183B3F95FADC4C3F189620E5797 /* CardView.xib */, + 1091A7C7D19C45920D87A3EAA1AA6C0F /* CenteredView.xib */, + 5088061C5D0ECA51E28E1D5C9C05CDF2 /* errorIcon.png */, + AA5472E591CE0BA4D0BA9BD216E9BBB0 /* errorIcon@2x.png */, + 6A7C4CC9232AC5706CBAB7721F33DE5B /* errorIcon@3x.png */, + 8F8C5C6E34EBE4F7FEFFD3E815727A10 /* errorIconLight.png */, + 8079F476C78D97C2FAE6BD81EEBC744F /* errorIconLight@2x.png */, + 3B2A150E6AA79141831952D08C9CA44A /* errorIconLight@3x.png */, + 0E783AAB1D182A47CE9A4C70AEA15DC7 /* errorIconSubtle.png */, + 4DB2CFEA6FDD21B6081185B3729B51D3 /* errorIconSubtle@2x.png */, + F1EB9AD47A886439B7A26D12430A76C1 /* errorIconSubtle@3x.png */, + D6597118FC7A651AD1C1B8186C857884 /* infoIcon.png */, + 9833C8624EAC2FC205C021937F16B47D /* infoIcon@2x.png */, + 648D06A574C08D26489A675BF3F8CC97 /* infoIcon@3x.png */, + 72EDEFFEFD9FA17167C3024ED8D81D74 /* infoIconLight.png */, + 6AAB51521257D54CBB370D9F3D32C816 /* infoIconLight@2x.png */, + 7E32BABB4A5EC5D4E83FB5D95173A917 /* infoIconLight@3x.png */, + 645A2EAB5E61532B3ABBCEBC6AF722C8 /* infoIconSubtle.png */, + D9B697009E9B2897D4182C96CC40388B /* infoIconSubtle@2x.png */, + 7288C4A89C8BEFB77574C7581276301B /* infoIconSubtle@3x.png */, + CB4BCAA40F9050DCE2E7581EECE3B199 /* MessageView.xib */, + C1B6942E8551B1ABFBEBCA492FA29A1F /* StatusLine.xib */, + AED77699F9B880BBE2EA3CCA45FEE504 /* successIcon.png */, + CE29AFF1B5B06DB5F46307D8CA2F94A2 /* successIcon@2x.png */, + DC15D52D5B4A8353B7433818CFC755C3 /* successIcon@3x.png */, + 17CAC30BEB11B3613D6C1DFA0950F7E9 /* successIconLight.png */, + 9166C75ED413481507005F77A9BEE4AF /* successIconLight@2x.png */, + 08510568CA8F1AEEDE5B0E32306DC71A /* successIconLight@3x.png */, + DBE15455BF19E1F22DA0EA9923EDDD39 /* successIconSubtle.png */, + 2987551134D451FC8A1024048B845790 /* successIconSubtle@2x.png */, + CFA306987494C26AB6494A2C70A32AE3 /* successIconSubtle@3x.png */, + 34EC4406FF95B83EF37D06F08D66A633 /* TabView.xib */, + 1899BB102CCB03C961D392531F94109C /* warningIcon.png */, + B1E88B937D987546110BF9126ADB22B0 /* warningIcon@2x.png */, + 95A39432E536B69E1F62334D0007FAC2 /* warningIcon@3x.png */, + 67E342B558FA9E3757D37EEB2E4D12A3 /* warningIconLight.png */, + 635E1C7D580143C90A7C99F9B6145CC7 /* warningIconLight@2x.png */, + 9A5FA7FE39BE7656FDDEB10178642B00 /* warningIconLight@3x.png */, + 063A43A32CE98A3E1C417772EB31679E /* warningIconSubtle.png */, + 2A7E3CFE0BA27926F6ABFC0513EF1282 /* warningIconSubtle@2x.png */, + 01CD4B0B843A3B4A985651F253653952 /* warningIconSubtle@3x.png */, + ); + name = Resources; + sourceTree = ""; + }; + 67587C3C2323DB96F9027E6F594C629F /* UIColor_Hex_Swift */ = { + isa = PBXGroup; + children = ( + 2F78D97A20A66B010C3E1ABDA41FFA5F /* HEXColor.h */, + CC2283864C5BFAC9FC50299F4F6071A9 /* StringExtension.swift */, + A600EBFC4D5E663BCCFC8D3C2BEF24A6 /* UIColorExtension.swift */, + BCCD5F85BBD560CCB2EB64FAB0B1F00B /* UIColorInputError.swift */, + 59123D44247562C173720EDD7EDC3E88 /* Support Files */, + ); + path = UIColor_Hex_Swift; + sourceTree = ""; + }; + 685AAE32654D08B0A9F021FD45A52D88 /* Products */ = { + isa = PBXGroup; + children = ( + 195AD71F7938FEA988FDCC5B0A10FFDF /* IGListDiffKit */, + B3C6C3E0B0FE2750FE588E0AFBA66D62 /* IGListKit */, + C3F44C782D64D7EB20B61CE3844EBFAD /* Kingfisher */, + 20F98B848D2BF72F16DA1BDACF869D1A /* Pods-Bulletin */, + 4824F23D80FF9070A5F8A452DB11EB9A /* SwiftMessages */, + 753DD909979478A0C1B33E0524504EF1 /* SwiftMessages-SwiftMessages */, + 58FA08FD4595D3CA9B2AA81405DE2EFA /* UIColor_Hex_Swift.framework */, + ); + name = Products; + sourceTree = ""; + }; + 7E2B523FF180B21B1BF18B644669F2C6 /* Kingfisher */ = { + isa = PBXGroup; + children = ( + 52372AE9D7E296FCED90D2D5BA9ECB4D /* AnimatedImageView.swift */, + 8D5B3DE73BA8320B88507E03E2B50D19 /* AuthenticationChallengeResponsable.swift */, + 802CFB873BF930917357D60645A37371 /* AVAssetImageDataProvider.swift */, + 3BE8BFF931E90A8B8F751859A979D9FF /* Box.swift */, + 92E3930B2051A71F0FD7F48F8E97C348 /* CacheSerializer.swift */, + BCB4CB332EC3A05BBA96845240C3B5C9 /* CallbackQueue.swift */, + A653BDF17479F16550C74F6CE6EA62F6 /* CPListItem+Kingfisher.swift */, + 0C09F9726B03BEFB76DB54470EFA079E /* Delegate.swift */, + A99E6797E0FD83202E415971B87BC2AE /* DiskStorage.swift */, + AD155FF57E053DCC59222AD9E9006734 /* ExtensionHelpers.swift */, + A481C64506F5FE39DE63847F8959BE5D /* Filter.swift */, + EC56036E713E5F3E1D5CF743FB2E30CE /* FormatIndicatedCacheSerializer.swift */, + 1D250E60DB977C9D0BFF53ABCA2A997C /* GIFAnimatedImage.swift */, + 31363CA02DABFE037A9597E66D774E50 /* GraphicsContext.swift */, + 3934169222833A8921F287D6737C3D94 /* Image.swift */, + FE009ADA0FD378470D467A226946D15F /* ImageBinder.swift */, + 3579EDF0F2B23FDC5BD85C5B34DC0AD6 /* ImageCache.swift */, + E69D9C2CA746D767CAFF47CD3F8F0BB8 /* ImageContext.swift */, + DEC751C1D0408841BADB8D95359DEDD0 /* ImageDataProcessor.swift */, + 19002AA8D6680BDDAC1C8C5DDE64CD49 /* ImageDataProvider.swift */, + DCD553D3612DC6CC76F894AF0823A794 /* ImageDownloader.swift */, + 2FFEB06874D80B62E4BA3E418B346091 /* ImageDownloaderDelegate.swift */, + 24C3AE2697C2C777471A4F671EFB544B /* ImageDrawing.swift */, + A88C71355EB0F8098D7C610310E5ADF9 /* ImageFormat.swift */, + 0C41EE63D598C9A869E2FAAF99E10B90 /* ImageModifier.swift */, + 18E261DDB018DEF41EF92A4794D0CC81 /* ImagePrefetcher.swift */, + 74DA03441BD1BDF74130264922D71B19 /* ImageProcessor.swift */, + 9615C14A8AD14AEA71CE750A1DA1EDF8 /* ImageProgressive.swift */, + 0F789B805ED414860F2DC4C723AFE42D /* ImageTransition.swift */, + 453ED79EFF2CFCB0BB28AAFB6728A746 /* ImageView+Kingfisher.swift */, + FDB7B3024FA7207F2C442C4AB05907D7 /* Indicator.swift */, + F0150DA8D834C8B8F37D02689D618EB7 /* KF.swift */, + 9D034498F4799F076DA40C62E1C1CF6A /* KFAnimatedImage.swift */, + DF93862F9459B5B5101367844C76ACFC /* KFImage.swift */, + 793410A19FBFCCE0BF378A5C8CF49BFA /* KFImageOptions.swift */, + 0662908419CF488E8FE10FE90D80D493 /* KFImageProtocol.swift */, + 225916A84FF5B787DDE7EB83441E3470 /* KFImageRenderer.swift */, + B4FD74B7B2B30A494ADC03256687A532 /* KFOptionsSetter.swift */, + AEDF019A7D273CA293038AC2E7E27AF7 /* Kingfisher.swift */, + CF130AF5100D6FFE94E45CAEC5B8222E /* KingfisherError.swift */, + 65601298C6B1A422CDB2DC07123D1E51 /* KingfisherManager.swift */, + D242674C42297EEEBD97DEE7B159B1AE /* KingfisherOptionsInfo.swift */, + 92E5783214B75AAE3D5847FC4443333D /* MemoryStorage.swift */, + DEDF7F99C596705FC4F572460885EBCD /* NSButton+Kingfisher.swift */, + ED7503AECAE5B4ACEDDA8E6EF1740523 /* NSTextAttachment+Kingfisher.swift */, + 53BF7416BD4A970D1B5E4B01F294E586 /* Placeholder.swift */, + C107FC92873BF8C1318FB8BAB48B491D /* RedirectHandler.swift */, + BB4552B30B4BEA7C253712647396FB87 /* RequestModifier.swift */, + 4B0D3AE0230F985AC1ED5587C52B99DB /* Resource.swift */, + 6688907CE0F1BF85B4A1ED07A4FD73BB /* Result.swift */, + C401DDB5E824718372BEB559155F340E /* RetryStrategy.swift */, + EBDB16CE65088B7BAADD99ED81716273 /* Runtime.swift */, + 9F5679710D252BC32A66875E79EE9BEB /* SessionDataTask.swift */, + D467CB3DCF65BE9C4B4067D5FFDD6859 /* SessionDelegate.swift */, + 1F3E90B88F5618F4D313769ED312089B /* SizeExtensions.swift */, + 80E936467024EE1D60D40AF511570E73 /* Source.swift */, + DA9BBA4DCEA951FBE5842187767A324A /* Storage.swift */, + 37B13934C4541B84DCD0CE345BE17813 /* String+MD5.swift */, + 71985F3B3B4297E61C48A92C40B847D8 /* TVMonogramView+Kingfisher.swift */, + AD245F26200BAD0F0C9385C5DEA429B7 /* UIButton+Kingfisher.swift */, + A3B6D0D716E13A355BB46955460FFB80 /* WKInterfaceImage+Kingfisher.swift */, + B8A20A7D7F1EBFDFFD7501C858866CEC /* Support Files */, + ); + path = Kingfisher; + sourceTree = ""; + }; + 876F7B3ED4F3B17FD0CD50CAAA681A04 /* iOS */ = { + isa = PBXGroup; + children = ( + EB56C884B7F74971F1D47C11641BD905 /* Accelerate.framework */, + 7388592716E23DB7918BA1CEF956BA19 /* CFNetwork.framework */, + 9060464159E13D7209F7D64BACF83DAD /* Foundation.framework */, + 007F365850B5C8A7EEA9E7F41F325B11 /* UIKit.framework */, + ); + name = iOS; + sourceTree = ""; + }; + 8CC0F3343BEDDC8D0126C8DC722D0B81 /* SwiftMessages */ = { + isa = PBXGroup; + children = ( + 189B53BB925CD0E96CFBEF2E63E4BDC3 /* App */, + 125B588671DF46336D0F8154F40DE542 /* Support Files */, + ); + path = SwiftMessages; + sourceTree = ""; + }; + 8CEC1A3C70C6B1B04C3B1F5803132750 /* Targets Support Files */ = { + isa = PBXGroup; + children = ( + 074A5B71721A1B3F50DB8082DDD11157 /* Pods-Bulletin */, + ); + name = "Targets Support Files"; + sourceTree = ""; + }; + B2C6EA9410FBA4324564C77CB2431009 /* IGListDiffKit */ = { + isa = PBXGroup; + children = ( + 969EC8B144DCFDBB8D6B20563FD767D8 /* IGListAssert.h */, + C904783C0CEAE96552A679C695669DBC /* IGListBatchUpdateData.h */, + 369EB2D2F32E873F3665AE2FB0A59DB9 /* IGListBatchUpdateData.mm */, + 15FF74DFD7DA6973B4D076F529572592 /* IGListCompatibility.h */, + 0495A674038D17605C95A9A5B9213100 /* IGListDiff.h */, + 974BF1702E4695985E60FBB45338A8A7 /* IGListDiff.mm */, + 03C406CF79037D94F19036ADEC84DAC7 /* IGListDiffable.h */, + E9EF2C50B2F9F3FC8C75CE92032462AA /* IGListDiffKit.h */, + 759C0577310E0EFEB52904517125DCF7 /* IGListExperiments.h */, + 4BED2EF6A3B24B9C0BF0E9524B7B6436 /* IGListIndexPathResult.h */, + E8101380E5E87B4F4EC6DDD9D53C9667 /* IGListIndexPathResult.m */, + 526AFE8B2C5F857BB1C8ACF879C0ECCE /* IGListIndexPathResultInternal.h */, + 7AC803E40D56EEDCA7EE11F40F5D2873 /* IGListIndexSetResult.h */, + F1D5521BDDA1A0242A36C1929596B475 /* IGListIndexSetResult.m */, + 07BC0E95B093644150AD1D0260560C1D /* IGListIndexSetResultInternal.h */, + 51A70695551771573DC2AA2EBA4C1856 /* IGListMacros.h */, + 896B6B102742772B634D79305645CA79 /* IGListMoveIndex.h */, + 28E5CF6FD87B92B31A35248BCCC7BDBE /* IGListMoveIndex.m */, + 308B9DAEAE417FCC8AB9D385110BAB88 /* IGListMoveIndexInternal.h */, + DF5E502A140B8C7136E1F676C002042C /* IGListMoveIndexPath.h */, + 92CF5980D57F9F674AE272CB46916FF0 /* IGListMoveIndexPath.m */, + 996DBB5DDFA8515120D75647C8498AE8 /* IGListMoveIndexPathInternal.h */, + 51E9A430A8CB278156CC969E105579DA /* NSNumber+IGListDiffable.h */, + 4E92132F1FBCAEC55FD846EB03A29C5C /* NSNumber+IGListDiffable.m */, + EF2222773C495CA6BA87AAAA93B049B9 /* NSString+IGListDiffable.h */, + 588967168C815A5579F4C6C0A3ADF4CA /* NSString+IGListDiffable.m */, + 43CF91C12C3F2936102F46DA4F2C7C75 /* Support Files */, + ); + path = IGListDiffKit; + sourceTree = ""; + }; + B8A20A7D7F1EBFDFFD7501C858866CEC /* Support Files */ = { + isa = PBXGroup; + children = ( + 841EA054CFC907C24018C45ADC5F3E63 /* Kingfisher.modulemap */, + 10FD14B174196E8692A3FF6CE273842B /* Kingfisher-dummy.m */, + 0F78C89D7312191E330B806A85A69672 /* Kingfisher-Info.plist */, + 2FA03600975416DCA7ED5BA333AC99DB /* Kingfisher-prefix.pch */, + EE7F5B9CFE3D767F3DB305EE26C2283F /* Kingfisher-umbrella.h */, + 7CB626D861306564520283F74F854D64 /* Kingfisher.debug.xcconfig */, + D2EC6A9540A860E7EDBF13CF404CB4B8 /* Kingfisher.release.xcconfig */, + ); + name = "Support Files"; + path = "../Target Support Files/Kingfisher"; + sourceTree = ""; + }; + BA4F31F07263C99FC76E66D632A59F09 /* Frameworks */ = { + isa = PBXGroup; + children = ( + 876F7B3ED4F3B17FD0CD50CAAA681A04 /* iOS */, + ); + name = Frameworks; + sourceTree = ""; + }; + CF1408CF629C7361332E53B88F7BD30C = { + isa = PBXGroup; + children = ( + 9D940727FF8FB9C785EB98E56350EF41 /* Podfile */, + BA4F31F07263C99FC76E66D632A59F09 /* Frameworks */, + 07FCA4F85284D25B675A378F88FBBA14 /* Pods */, + 685AAE32654D08B0A9F021FD45A52D88 /* Products */, + 8CEC1A3C70C6B1B04C3B1F5803132750 /* Targets Support Files */, + ); + sourceTree = ""; + }; +/* End PBXGroup section */ + +/* Begin PBXHeadersBuildPhase section */ + 19125098D221B2D8C5F1214DAE4046C3 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + 4EE2EC2F10C2D2BC999CE30C679575FB /* HEXColor.h in Headers */, + 3DB2320AF24E5F4C92900577EE44878C /* UIColor_Hex_Swift-umbrella.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 3229198688E541F69F93DB2A2878FFE6 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + 840F7452FC8C95F23BF04DD115213F2D /* IGListAdapter.h in Headers */, + 504FC6E2898BB2EAA2099072FBECB8B8 /* IGListAdapter+DebugDescription.h in Headers */, + 9CE4B00AD0EFD1C0A048270DA64986B2 /* IGListAdapter+UICollectionView.h in Headers */, + 248A5D0758579F45393A48F7F1A816EE /* IGListAdapterDataSource.h in Headers */, + F28F7B608086B6126003F02D8F79D79F /* IGListAdapterDelegate.h in Headers */, + C0BB4FD34FBDE2C9E8571DD42F56FDD3 /* IGListAdapterInternal.h in Headers */, + 857AB5F39FCA5E1F81A5D20A3A16DD19 /* IGListAdapterMoveDelegate.h in Headers */, + 7CFC6E5C81DB4F42F1C469C8194FE64C /* IGListAdapterPerformanceDelegate.h in Headers */, + E1128C6D632504B9D7AF99B3838D3DCC /* IGListAdapterProxy.h in Headers */, + 07ED65FC8B25E7420799D68D2CC59E7D /* IGListAdapterUpdateListener.h in Headers */, + 9ED0DFF2B7B21C647DDFC8559C9479C2 /* IGListAdapterUpdater.h in Headers */, + 9BDCB75960A60DD0DEE0FA6101987B26 /* IGListAdapterUpdater+DebugDescription.h in Headers */, + DF12FA0162AEB2360E9D896FFCE3D8FD /* IGListAdapterUpdaterDelegate.h in Headers */, + 770A7C634F7BBC9E2C030AAC217A383C /* IGListAdapterUpdaterInternal.h in Headers */, + 7597FD2790FC3E3002CC855FDF1EEFAB /* IGListArrayUtilsInternal.h in Headers */, + C3F1FE6BB2F3E83DF225DB091D768ED3 /* IGListBatchContext.h in Headers */, + DA36BB36699075B706863F8E6462F524 /* IGListBatchUpdateData+DebugDescription.h in Headers */, + 29A7C0BC88D85F89318C67E6293CFFB4 /* IGListBatchUpdates.h in Headers */, + 74021AE8DA8068962E566374E4097561 /* IGListBatchUpdateState.h in Headers */, + 3E9D03B9D56D435F1387EEE5B848D0C7 /* IGListBindable.h in Headers */, + 653E4F4EE5A4AE7C8E2C2BD9BE9AD111 /* IGListBindingSectionController.h in Headers */, + C78B03AD94E9ADA8E4A492D852A4036D /* IGListBindingSectionController+DebugDescription.h in Headers */, + AD951EA8C76B4AE7CFB4669804B8275B /* IGListBindingSectionControllerDataSource.h in Headers */, + 4735A168EFDF0E56425C926BCEF42F33 /* IGListBindingSectionControllerSelectionDelegate.h in Headers */, + D8332E09169A7A9D00E0398D4392DB70 /* IGListCollectionContext.h in Headers */, + 5EBA64E274109B68134E970A1C831236 /* IGListCollectionScrollingTraits.h in Headers */, + 8933125F14AA552ACB4B02ACEAC95A46 /* IGListCollectionView.h in Headers */, + 9C5254A71019F6D346E643611192AAF4 /* IGListCollectionViewDelegateLayout.h in Headers */, + 0D293ABB2BD3C45D748001FF3929AD4B /* IGListCollectionViewLayout.h in Headers */, + 456D4E89F94D07D831D2D06212DD3A21 /* IGListCollectionViewLayoutCompatible.h in Headers */, + 73BC2BAEAFC76A79BF2A6E23CA54044F /* IGListCollectionViewLayoutInternal.h in Headers */, + A404C0924ECF70F20F76E1AA5F32876D /* IGListDebugger.h in Headers */, + 1199F40D641095A06DC44FA62F589282 /* IGListDebuggingUtilities.h in Headers */, + 0CFD8E5542E0804B92A255670C94AB24 /* IGListDisplayDelegate.h in Headers */, + 627B24A21C799D9876E8EDA4C203EB5C /* IGListDisplayHandler.h in Headers */, + F6CA0DA52CCF6EB9B47B22196FA14E3E /* IGListGenericSectionController.h in Headers */, + 395296368FAD6FEE70CE19FBCE22C316 /* IGListIndexPathResultInternal.h in Headers */, + 3F69A921AA08DB133E702F3F7C395405 /* IGListIndexSetResultInternal.h in Headers */, + D0D540212AFD7154B4C9207A9E5C911A /* IGListKit.h in Headers */, + A19366C6BC7101DC193D92176EB89C37 /* IGListKit-umbrella.h in Headers */, + F7EF7184D41C22A77D70A2AE233D4E53 /* IGListMoveIndexInternal.h in Headers */, + 5C1B342A3F54657EEA7FC2105EF75523 /* IGListMoveIndexPathInternal.h in Headers */, + 145318846A4197187343A7223A8366BF /* IGListReloadDataUpdater.h in Headers */, + A1FFF4B8FB3410D63594007BBA288632 /* IGListReloadIndexPath.h in Headers */, + 7448C55AC852D9DD05F91D03E7430E4C /* IGListScrollDelegate.h in Headers */, + 4B86DE37B3B553A574A54CCDDBC13680 /* IGListSectionController.h in Headers */, + BF8F8C64DB7DBEC09546AE2C68B1929B /* IGListSectionControllerInternal.h in Headers */, + 0052866F22FC243E2A20CC326BFF3F58 /* IGListSectionMap.h in Headers */, + A306349DCF43F00C535D8A7C2B5DDE55 /* IGListSectionMap+DebugDescription.h in Headers */, + E0B5B9AA33DBB50133BF1886B076688A /* IGListSingleSectionController.h in Headers */, + 256BA1F1360654F69778E29BBE25B04D /* IGListSupplementaryViewSource.h in Headers */, + 73448A3812B760B85DD6B64B85B49165 /* IGListTransitionDelegate.h in Headers */, + EB11BE0DBFDA8DFB6DA4A0C9AA39DEAE /* IGListUpdatingDelegate.h in Headers */, + 8AC9E9ACB2C52077863D538C75C1E430 /* IGListWorkingRangeDelegate.h in Headers */, + B1DAC65FFC831F6D51EAC90BD4B4D92D /* IGListWorkingRangeHandler.h in Headers */, + 61976AFFB89BE9B4FFCCE448B16B895D /* UICollectionView+DebugDescription.h in Headers */, + 0C5AD6C37D168B6D4CEC37F24AEFEF9C /* UICollectionView+IGListBatchUpdateData.h in Headers */, + 6E3E76E4A7F77A3973EE6449CE275137 /* UICollectionViewLayout+InteractiveReordering.h in Headers */, + 29A9E81F33421D1E32648B12D20B4F68 /* UIScrollView+IGListKit.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 366AE1807437E1222BD7F8F084E53552 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + F2DC134E310796CDE38903CADC436726 /* Pods-Bulletin-umbrella.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 3D78E6B12D0C7704AA6257B6D7CE969B /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + E290630326514476CA3D4651D3FB2C12 /* SwiftMessages-umbrella.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 7AE52B176E9872452FD890FC7F460CE1 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + 122980E44B15C64CF0B14DC94D7EB5C9 /* Kingfisher-umbrella.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + F0A5A4D19AE00FBC278C2B9513587246 /* Headers */ = { + isa = PBXHeadersBuildPhase; + buildActionMask = 2147483647; + files = ( + E7E6D0A1C2F66770BE1A484A01B01A63 /* IGListAssert.h in Headers */, + 2D2A77A53A45AA03F16F2411E6F7FEB7 /* IGListBatchUpdateData.h in Headers */, + EE402590604403A03F734B8AD641AAD9 /* IGListCompatibility.h in Headers */, + 769764555AF9B0D77F7D1BDF6694A0F3 /* IGListDiff.h in Headers */, + AB3D4BBA18DEA9DDCB82E15EE6DA80FE /* IGListDiffable.h in Headers */, + 637DFADEF4F664E6E6932F0E27472FD5 /* IGListDiffKit.h in Headers */, + 4E69250DFE230B7D9134B5360A91EC8D /* IGListDiffKit-umbrella.h in Headers */, + 8EF72BE56C31A8A67872154F61605B81 /* IGListExperiments.h in Headers */, + 5456CE7488C7FE316C00605531107BFD /* IGListIndexPathResult.h in Headers */, + A0778F3A26137BE9262E2F4E042D04DF /* IGListIndexPathResultInternal.h in Headers */, + 7D6EB166CD4530B9E1CB943798269D5B /* IGListIndexSetResult.h in Headers */, + 2D4F11BB21F21B0F1687BDA71200EB74 /* IGListIndexSetResultInternal.h in Headers */, + 6A3B187375746C0888E5CFCDD868FCCB /* IGListMacros.h in Headers */, + 53526734412F401A087EC20F9A3CC7EB /* IGListMoveIndex.h in Headers */, + FC9E1CBF800DFB8FE8F0E29D1CB8EA1A /* IGListMoveIndexInternal.h in Headers */, + 0F9B2F409EF8A5AADE05FC337C4F4B20 /* IGListMoveIndexPath.h in Headers */, + 37E2C53DDA53EE7696F3C78A095A70C2 /* IGListMoveIndexPathInternal.h in Headers */, + 0ABF3498CC7F1EB2B3B3EA0648268D58 /* NSNumber+IGListDiffable.h in Headers */, + 1B2DDB8AD9504EB5AF857E4A45E3A979 /* NSString+IGListDiffable.h in Headers */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXHeadersBuildPhase section */ + +/* Begin PBXNativeTarget section */ + 216ED480D97315FF6DBB931E55B48AB1 /* Pods-Bulletin */ = { + isa = PBXNativeTarget; + buildConfigurationList = 61FD5F1D788300894E920658B01F90CA /* Build configuration list for PBXNativeTarget "Pods-Bulletin" */; + buildPhases = ( + 366AE1807437E1222BD7F8F084E53552 /* Headers */, + 10B66A67CB479C53B770CAD85D267537 /* Sources */, + 1590561D96F3E074FE469B04D8F764C8 /* Frameworks */, + 6462E53101F75019610E24424EB457AF /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 4AB106F6C169F1F7C5633FFC0EED5546 /* PBXTargetDependency */, + 3C96041AF97B074F4C690C5C62A6368B /* PBXTargetDependency */, + DF5A26E717434EAE7445B6AA418E6781 /* PBXTargetDependency */, + 02CC40193B2425741A35E17204B03688 /* PBXTargetDependency */, + 5C0C1B16990CADEC6C388F5C3EE827D2 /* PBXTargetDependency */, + ); + name = "Pods-Bulletin"; + productName = Pods_Bulletin; + productReference = 20F98B848D2BF72F16DA1BDACF869D1A /* Pods-Bulletin */; + productType = "com.apple.product-type.framework"; + }; + 2D07A05F514BF9C5434DAC907988C708 /* IGListDiffKit */ = { + isa = PBXNativeTarget; + buildConfigurationList = 124A39A4C3D1564DB02296737FECE89C /* Build configuration list for PBXNativeTarget "IGListDiffKit" */; + buildPhases = ( + F0A5A4D19AE00FBC278C2B9513587246 /* Headers */, + AA9AF8B13C4EC8776F28671C673BA38B /* Sources */, + 0DC33FC81EEF5C13DC2B4EF85CA14F78 /* Frameworks */, + 8B08ACC7E062463EF1B86EAAE6986B51 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = IGListDiffKit; + productName = IGListDiffKit; + productReference = 195AD71F7938FEA988FDCC5B0A10FFDF /* IGListDiffKit */; + productType = "com.apple.product-type.framework"; + }; + 674FDCAB4D51E702521F4CD31807F659 /* IGListKit */ = { + isa = PBXNativeTarget; + buildConfigurationList = 15F7B5F2389DC795EC831863F9DF95D5 /* Build configuration list for PBXNativeTarget "IGListKit" */; + buildPhases = ( + 3229198688E541F69F93DB2A2878FFE6 /* Headers */, + FC6E57FBE94AA87B13A2A82116BCE1C0 /* Sources */, + F7EC70ECA9F3248B43189E7C38690FA1 /* Frameworks */, + 6274298B3835F66040958FCB20E78D0C /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + D2B8578FFD713994A8FFF50F2D3EBFB8 /* PBXTargetDependency */, + ); + name = IGListKit; + productName = IGListKit; + productReference = B3C6C3E0B0FE2750FE588E0AFBA66D62 /* IGListKit */; + productType = "com.apple.product-type.framework"; + }; + 93789445511E3FEAB3D09A6F552EEE2D /* SwiftMessages-SwiftMessages */ = { + isa = PBXNativeTarget; + buildConfigurationList = 3EBF158ED6C977460E2094CBA2B9AFC1 /* Build configuration list for PBXNativeTarget "SwiftMessages-SwiftMessages" */; + buildPhases = ( + 1347383E8A3EA46FFEE4DA065D68A000 /* Sources */, + 524D0CCC1F888BC91F616D53B4C381E8 /* Frameworks */, + 871EF57FA89342B1161F07B798088308 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = "SwiftMessages-SwiftMessages"; + productName = SwiftMessages; + productReference = 753DD909979478A0C1B33E0524504EF1 /* SwiftMessages-SwiftMessages */; + productType = "com.apple.product-type.bundle"; + }; + A0CA3B0841360687C00D0E48D3E4C1B9 /* UIColor_Hex_Swift */ = { + isa = PBXNativeTarget; + buildConfigurationList = E22B609ECAEFA85B75A98369FF2A6B24 /* Build configuration list for PBXNativeTarget "UIColor_Hex_Swift" */; + buildPhases = ( + 19125098D221B2D8C5F1214DAE4046C3 /* Headers */, + D890B797D9B7D90296E55AB16B09E319 /* Sources */, + 5C9B3C65E54998F5193CA304A90C9083 /* Frameworks */, + 138A97688963F4E7BFE825F22241B122 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = UIColor_Hex_Swift; + productName = UIColor_Hex_Swift; + productReference = 58FA08FD4595D3CA9B2AA81405DE2EFA /* UIColor_Hex_Swift.framework */; + productType = "com.apple.product-type.framework"; + }; + DAB613A18652334F6BFC5F27BADF515D /* SwiftMessages */ = { + isa = PBXNativeTarget; + buildConfigurationList = 4FD7C2B04E1FC5365718930ADC799D5C /* Build configuration list for PBXNativeTarget "SwiftMessages" */; + buildPhases = ( + 3D78E6B12D0C7704AA6257B6D7CE969B /* Headers */, + A65DC52B960385FEF4808166660E82D7 /* Sources */, + 1E5F34F325312F632646732A454D6AD6 /* Frameworks */, + 2748DBA8705A702EA4150DD61A19FD69 /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + 0491256AEC27E3A33CE795014F28F2FD /* PBXTargetDependency */, + ); + name = SwiftMessages; + productName = SwiftMessages; + productReference = 4824F23D80FF9070A5F8A452DB11EB9A /* SwiftMessages */; + productType = "com.apple.product-type.framework"; + }; + E8022D22FAA6690B5E1C379C1BCE1491 /* Kingfisher */ = { + isa = PBXNativeTarget; + buildConfigurationList = 69ACD8654734266A348C6FF68E734010 /* Build configuration list for PBXNativeTarget "Kingfisher" */; + buildPhases = ( + 7AE52B176E9872452FD890FC7F460CE1 /* Headers */, + 3C1DA515D615F8CE75565ACE14378882 /* Sources */, + 81DB1665E1495609510BA493822E5A85 /* Frameworks */, + CFEB3E9FD20A01120B40D65B82D8F26F /* Resources */, + ); + buildRules = ( + ); + dependencies = ( + ); + name = Kingfisher; + productName = Kingfisher; + productReference = C3F44C782D64D7EB20B61CE3844EBFAD /* Kingfisher */; + productType = "com.apple.product-type.framework"; + }; +/* End PBXNativeTarget section */ + +/* Begin PBXProject section */ + BFDFE7DC352907FC980B868725387E98 /* Project object */ = { + isa = PBXProject; + attributes = { + LastSwiftUpdateCheck = 1300; + LastUpgradeCheck = 1300; + }; + buildConfigurationList = 4821239608C13582E20E6DA73FD5F1F9 /* Build configuration list for PBXProject "Pods" */; + compatibilityVersion = "Xcode 14.0"; + developmentRegion = en; + hasScannedForEncodings = 0; + knownRegions = ( + Base, + en, + ); + mainGroup = CF1408CF629C7361332E53B88F7BD30C; + productRefGroup = 685AAE32654D08B0A9F021FD45A52D88 /* Products */; + projectDirPath = ""; + projectRoot = ""; + targets = ( + 2D07A05F514BF9C5434DAC907988C708 /* IGListDiffKit */, + 674FDCAB4D51E702521F4CD31807F659 /* IGListKit */, + E8022D22FAA6690B5E1C379C1BCE1491 /* Kingfisher */, + 216ED480D97315FF6DBB931E55B48AB1 /* Pods-Bulletin */, + DAB613A18652334F6BFC5F27BADF515D /* SwiftMessages */, + 93789445511E3FEAB3D09A6F552EEE2D /* SwiftMessages-SwiftMessages */, + A0CA3B0841360687C00D0E48D3E4C1B9 /* UIColor_Hex_Swift */, + ); + }; +/* End PBXProject section */ + +/* Begin PBXResourcesBuildPhase section */ + 138A97688963F4E7BFE825F22241B122 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 2748DBA8705A702EA4150DD61A19FD69 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 6E5BC0F0DF1D4D4C3A81A3B1ABEB2E52 /* SwiftMessages-SwiftMessages in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 6274298B3835F66040958FCB20E78D0C /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 6462E53101F75019610E24424EB457AF /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 871EF57FA89342B1161F07B798088308 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 106E77E6CCA0360F0EBCC653774E25F5 /* CardView.xib in Resources */, + 52800834B090075CA6F35EF7306B5AE5 /* CenteredView.xib in Resources */, + C8ED20CFCDFF904961EA7D6FCFAD1AAF /* errorIcon.png in Resources */, + 48065C2580FF9E5D2DE0E6447AACB110 /* errorIcon@2x.png in Resources */, + 404DCA74511EDA44B896202CD64458A0 /* errorIcon@3x.png in Resources */, + 08CA1A7B0A9F6B96CA4DFCFF977759CC /* errorIconLight.png in Resources */, + EE3740A3D6C42F3766288ED5BCB8B95D /* errorIconLight@2x.png in Resources */, + 1BCE5E9382038062602EC3B882B0B1C1 /* errorIconLight@3x.png in Resources */, + 4A3FACE084B0154043BD4015B3E8FCC2 /* errorIconSubtle.png in Resources */, + 8FB6113E9C4FFEB7A580060F3040B53C /* errorIconSubtle@2x.png in Resources */, + 83557F428BB0AF138061AD66390FAE57 /* errorIconSubtle@3x.png in Resources */, + F4852EA1DC3E1F1F346402EAEFE1109F /* infoIcon.png in Resources */, + 3A16D398DAB6AFE26767E5B5E9A37767 /* infoIcon@2x.png in Resources */, + 21191DB3B6E3981B1D9682644743FF7E /* infoIcon@3x.png in Resources */, + 94E07ACBB6D1F91A84009EE52CA247AD /* infoIconLight.png in Resources */, + BC34CECDF734877FE9651B831504D3F2 /* infoIconLight@2x.png in Resources */, + 96BA7BD41B99BCBE403CFC49DF217990 /* infoIconLight@3x.png in Resources */, + 724DBA853B4874B96363B04EA98D4147 /* infoIconSubtle.png in Resources */, + FF467117653668E74E2DA504B3BC3547 /* infoIconSubtle@2x.png in Resources */, + 13786D2762D17C2F6715CA62D64AE76B /* infoIconSubtle@3x.png in Resources */, + 36AA900737FE6B23825191A9011181DB /* MessageView.xib in Resources */, + 4B7802B665FAD2255F4A3D5FADE64B08 /* StatusLine.xib in Resources */, + 39A7FD94C1F455775CBBBC49131CDE98 /* successIcon.png in Resources */, + 6D093916DC5318912596E0AD1AA26238 /* successIcon@2x.png in Resources */, + 2D7DD1D4C822CE247530FAFBF36B41B4 /* successIcon@3x.png in Resources */, + 2CC46C11380D37A6DE73F58D4DEFF754 /* successIconLight.png in Resources */, + 9F9F378DCF1582EBC63B23D9C8E2F238 /* successIconLight@2x.png in Resources */, + 76E95598BA0A70C68E8782BC178A0B86 /* successIconLight@3x.png in Resources */, + B7384B67D262049B7A3D9A5F44CF3AD8 /* successIconSubtle.png in Resources */, + 82925050E10EBBC55386CBB189824F09 /* successIconSubtle@2x.png in Resources */, + D1354255D2A30A71D2915BD7A0D10960 /* successIconSubtle@3x.png in Resources */, + 6354E790FC26E29FFFAB6F298404FE52 /* TabView.xib in Resources */, + 93149C816CBB4ED433D3A3EE6F5B9372 /* warningIcon.png in Resources */, + C111B17154D65AFC9862B663697D1C5C /* warningIcon@2x.png in Resources */, + A426AB76106748CDFB137114A6F63935 /* warningIcon@3x.png in Resources */, + 4AD71B305F0FFBCD1859562AA2F86A29 /* warningIconLight.png in Resources */, + 80AF29D95B77B1DFCBF7F674954A8513 /* warningIconLight@2x.png in Resources */, + 29CE33F429B08D390973ADE3F05A097F /* warningIconLight@3x.png in Resources */, + 12D9C86DE5B35895C8C4C2F66D98EF81 /* warningIconSubtle.png in Resources */, + 500C34AE9C3CBFFE6854C3627328C849 /* warningIconSubtle@2x.png in Resources */, + DD46E684526BF2A6315775DEBCA54960 /* warningIconSubtle@3x.png in Resources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 8B08ACC7E062463EF1B86EAAE6986B51 /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + CFEB3E9FD20A01120B40D65B82D8F26F /* Resources */ = { + isa = PBXResourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXResourcesBuildPhase section */ + +/* Begin PBXSourcesBuildPhase section */ + 10B66A67CB479C53B770CAD85D267537 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 92A554C6D0F616D62454C16FA59D8183 /* Pods-Bulletin-dummy.m in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 1347383E8A3EA46FFEE4DA065D68A000 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + ); + runOnlyForDeploymentPostprocessing = 0; + }; + 3C1DA515D615F8CE75565ACE14378882 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 1952485AFF7A1BCCA4D4B142E82FE627 /* AnimatedImageView.swift in Sources */, + 243D7CFE1D56ED80ACB2B3E71B4CB603 /* AuthenticationChallengeResponsable.swift in Sources */, + D603AA58EF97D461A57B2B1BCB883868 /* AVAssetImageDataProvider.swift in Sources */, + B25E07EA645911443A38DA1E68166156 /* Box.swift in Sources */, + CD7AC3E1C98EA54F7C05C36C52805220 /* CacheSerializer.swift in Sources */, + FF09824309346665E2F1F7F5A45FB10F /* CallbackQueue.swift in Sources */, + DBB8088E14A2ADEDB1CD840BAC835267 /* CPListItem+Kingfisher.swift in Sources */, + 457BE444ED617FA7D6851D6DAA9D7234 /* Delegate.swift in Sources */, + 1FEE89BF952BE7ACA46E642DA2E48CA2 /* DiskStorage.swift in Sources */, + 1185A2B40E14F2FCBC761FC99777CAD8 /* ExtensionHelpers.swift in Sources */, + 3AF7DB9AEFF47F1F7F91AF28440E4AC6 /* Filter.swift in Sources */, + DE532EF7D50A9CF68587DAD4C1A02BD7 /* FormatIndicatedCacheSerializer.swift in Sources */, + F24021BDE9B42D604E3341CAD8E34759 /* GIFAnimatedImage.swift in Sources */, + 582D59E0D2EF62E0575933C99B393704 /* GraphicsContext.swift in Sources */, + 70FEC06F54286257E1BA1ECA0C99198D /* Image.swift in Sources */, + 1AA89F327105C026976BF6E831B193A2 /* ImageBinder.swift in Sources */, + ED0C8BA7560D7324587B353E0960479F /* ImageCache.swift in Sources */, + F5414F8A5B40521D0E4AEEB28378CB49 /* ImageContext.swift in Sources */, + 80738D8956C9987CCCEDF551961E5069 /* ImageDataProcessor.swift in Sources */, + 0285857A24F66E925987A5876F0BE63B /* ImageDataProvider.swift in Sources */, + DD72DC30CF19FFC81AB19CD0B074000D /* ImageDownloader.swift in Sources */, + 881A35B28D93C56E46E305F6138B1A76 /* ImageDownloaderDelegate.swift in Sources */, + DAFC6CE6321395CF4523DD66DADBB9BA /* ImageDrawing.swift in Sources */, + E6D6C7D5E458A05CC736C340F853E9F6 /* ImageFormat.swift in Sources */, + F54DE563418B1783D6EC491A0C3A05DB /* ImageModifier.swift in Sources */, + 00BEA6029C428FEE644AC3D42AD83282 /* ImagePrefetcher.swift in Sources */, + EF9C4588CDA85AED8BBCF77451B2A35B /* ImageProcessor.swift in Sources */, + 5F852F38CBC282496CCBE37C51324B2F /* ImageProgressive.swift in Sources */, + 29FF13E23FD52E46D30530549410AD7C /* ImageTransition.swift in Sources */, + E5B664771063F1A9A372519A8466860B /* ImageView+Kingfisher.swift in Sources */, + DFCDE4638265B4CCD494ECA5D560DBEE /* Indicator.swift in Sources */, + DF4563832C19B8582C810BF502A5CA29 /* KF.swift in Sources */, + 7FFE4021A4F14124342AD41CE1117B3E /* KFAnimatedImage.swift in Sources */, + 5E27DD292D3A55657712DD7AFA7B8FCA /* KFImage.swift in Sources */, + 5ADB30DD9A03859018550A999ACB0652 /* KFImageOptions.swift in Sources */, + F9537B023E24AC4A724E301F7E372491 /* KFImageProtocol.swift in Sources */, + 0510E8EA51914CB2176AD0F173937FAB /* KFImageRenderer.swift in Sources */, + A316388A35648CB2987E761771456087 /* KFOptionsSetter.swift in Sources */, + A39D3555EC8B45B7D6B9505DDAF0F117 /* Kingfisher.swift in Sources */, + 4DCA9775E5CCF599460BDB46E77F6FA4 /* Kingfisher-dummy.m in Sources */, + 4F37E521D341C47CE73DDCF21BA95A52 /* KingfisherError.swift in Sources */, + 1FE693B5ACC6AD7320CEFC20B64546E4 /* KingfisherManager.swift in Sources */, + 05228565AAA7FCED4BAFB2B7EF71D53D /* KingfisherOptionsInfo.swift in Sources */, + 1FD2928BC156D990D68B105F518C60B6 /* MemoryStorage.swift in Sources */, + 059639E700DEFAEF08F56484E5F67BE7 /* NSButton+Kingfisher.swift in Sources */, + 59BC9047F4BEBBC06235608D974E230D /* NSTextAttachment+Kingfisher.swift in Sources */, + 506128E1CC424E40E2691546D9547549 /* Placeholder.swift in Sources */, + 2BE89C24BFD3FB663E37C607C289B3B6 /* RedirectHandler.swift in Sources */, + 509490FB1D30FEC59AE4BC21AEEBB7BB /* RequestModifier.swift in Sources */, + 22BD1346F66BFCB129AAA44EEF322AC9 /* Resource.swift in Sources */, + A88A844D5356E1690E445024CB796E09 /* Result.swift in Sources */, + 22216C300C763044344B9DBF97317E63 /* RetryStrategy.swift in Sources */, + EBB32304E8DD4BA115454E0050D47DED /* Runtime.swift in Sources */, + 7C7418FF01DD7BB909719682B634A8A5 /* SessionDataTask.swift in Sources */, + 0ED8FBFD9A86D21BF69137EC9350E575 /* SessionDelegate.swift in Sources */, + 57FC31B14C753B5C63CEF00560F8A6EF /* SizeExtensions.swift in Sources */, + 9B0A78AC22E7EDA755F51D86527E2D9C /* Source.swift in Sources */, + 25FC036BEA33CAB5D80F5A41644535D3 /* Storage.swift in Sources */, + BD382E78580D295D10100678D4F66A76 /* String+MD5.swift in Sources */, + F17B1F8F2B6580343025237455A29D61 /* TVMonogramView+Kingfisher.swift in Sources */, + 082EDC820D76DF95C71A5018112DE512 /* UIButton+Kingfisher.swift in Sources */, + 9F5FE22DA95B66B8DC21CB13BE25EC9B /* WKInterfaceImage+Kingfisher.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + A65DC52B960385FEF4808166660E82D7 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + DD87BCC0696946A029E25B638BFB1971 /* AccessibleMessage.swift in Sources */, + 7947B831C0A0B1D6E01E862603BB6369 /* Animator.swift in Sources */, + 26A9A1D5029BDEB2C0AF0ECFE65ECBB6 /* BackgroundViewable.swift in Sources */, + ABAD2E2E0682AB7FF1C6213388E4EBA2 /* BaseView.swift in Sources */, + A55902F47A9DACFEAC7D0833A569911E /* CALayer+Extensions.swift in Sources */, + AFCAEA6F64C31BBCA51EDE0A22C971FF /* CornerRoundingView.swift in Sources */, + 8AF999CCB198F34068E9AC558864262D /* Error.swift in Sources */, + 6C4C53377507F9D77E67A19F3B0DAE69 /* Identifiable.swift in Sources */, + 69A39E2DCEE7140DF3654C581C401637 /* KeyboardTrackingView.swift in Sources */, + 2CDD1385DB4E94B72AA923A2DB34D030 /* MarginAdjustable.swift in Sources */, + EE2007369A32179A1540374E29C343AE /* MarginAdjustable+Extensions.swift in Sources */, + 2A44FC42DA4E309A6CD0C23845E62FDD /* MaskingView.swift in Sources */, + AEB007C7128575842880AD5559D2D5AC /* MessageView.swift in Sources */, + BFAB4C4DAEFAAE316F3F7006D0E7F45B /* NSBundle+Extensions.swift in Sources */, + A9CCA2DCDE1D1EA45BAD74C5CB3E9253 /* NSLayoutConstraint+Extensions.swift in Sources */, + EF73165F049DB4864538A394FFCBE874 /* PassthroughView.swift in Sources */, + 93427084C7854C572B84FF0C78CAD7C5 /* PassthroughWindow.swift in Sources */, + AD707CFC669380B926AFB1FE7AE9B867 /* PhysicsAnimation.swift in Sources */, + FA006B42B99DAF8263341881FD510FF9 /* PhysicsPanHandler.swift in Sources */, + 33634B64A37F709874AB14578331B98D /* Presenter.swift in Sources */, + AC348A3AA450BFA43A0B4869FB82772A /* SwiftMessages.swift in Sources */, + 08107140946FA9287B2C63728BFABB2E /* SwiftMessages-dummy.m in Sources */, + 7A5320B15F6789F272E61C44F9F4DBB0 /* SwiftMessages.Config+Extensions.swift in Sources */, + 137EF15CD62928D2E8C32B18E35CDA84 /* SwiftMessagesSegue.swift in Sources */, + 645463E624115A42FE45DD945C41DB40 /* Theme.swift in Sources */, + 7E08A94F10299EADB052CAE34F2BFA00 /* TopBottomAnimation.swift in Sources */, + 7E98E18B747F60326E4BA87E15839F29 /* UIEdgeInsets+Extensions.swift in Sources */, + 1F727CB62A71B2ABE2CA4FBDC563A4A1 /* UIViewController+Extensions.swift in Sources */, + 75240B35A5337C0362A81BA4E19C50A8 /* UIWindow+Extensions.swift in Sources */, + 1EEBEB3E8E43888EFF440D810F4FE61F /* Weak.swift in Sources */, + BB2B1C8268535C8BB056EB34B907FE16 /* WindowScene.swift in Sources */, + A122D2A3C925C48C11A200271047323E /* WindowViewController.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + AA9AF8B13C4EC8776F28671C673BA38B /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + E362C21CF43363A849410617D9B0A524 /* IGListBatchUpdateData.mm in Sources */, + D05EC2EA72C86F0F25AC384102DE7238 /* IGListDiff.mm in Sources */, + 5752BA2732399E70CFA4026649B32D3B /* IGListDiffKit-dummy.m in Sources */, + F209D62202BD5D087E33685E52308500 /* IGListIndexPathResult.m in Sources */, + 7BB3B41A692D42272CEB3CD6023A97B8 /* IGListIndexSetResult.m in Sources */, + DA537286B85140EC0B108E803DFB545E /* IGListMoveIndex.m in Sources */, + 0B5893ABAF3F5EB6896FF6748BA24B9D /* IGListMoveIndexPath.m in Sources */, + 9E2B220A2A3223F08334BBCBDFEE5BC3 /* NSNumber+IGListDiffable.m in Sources */, + FF3EB79404B1F1AF27E7298F4DF62FA2 /* NSString+IGListDiffable.m in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + D890B797D9B7D90296E55AB16B09E319 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + 3EEE359E3EA05A87BEABA426D6092571 /* StringExtension.swift in Sources */, + 2EB12379C6E40E835D1AC08FAADFC392 /* UIColor_Hex_Swift-dummy.m in Sources */, + 20A92FC736588CF2C5688AFD384EAD9D /* UIColorExtension.swift in Sources */, + D005E9A215793DD5E318F94052C45350 /* UIColorInputError.swift in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; + FC6E57FBE94AA87B13A2A82116BCE1C0 /* Sources */ = { + isa = PBXSourcesBuildPhase; + buildActionMask = 2147483647; + files = ( + C0E2F479332ED0297D2152651EEBBC32 /* IGListAdapter.m in Sources */, + C3CE74410F050DCA5E2C8E1FF26A1125 /* IGListAdapter+DebugDescription.m in Sources */, + 31D2A0320106459AC5D7A31F8C41646B /* IGListAdapter+UICollectionView.m in Sources */, + E5FEA90E76B8D19728AE8D30969EB744 /* IGListAdapterProxy.m in Sources */, + 8A465CC2B4BB341735A5AEB15B28C587 /* IGListAdapterUpdater.m in Sources */, + 290CE4B2273A8DD7501C883649D798F4 /* IGListAdapterUpdater+DebugDescription.m in Sources */, + E4B7D3D7779F1394C8104CF3615EC223 /* IGListBatchUpdateData+DebugDescription.m in Sources */, + 3F2E1FB46259BAF163598529C1925BCB /* IGListBatchUpdates.m in Sources */, + F5FC561E72803649ED1023E463AB9D17 /* IGListBindingSectionController.m in Sources */, + F105D53A3A5A848EA428305ACF3FDBBB /* IGListBindingSectionController+DebugDescription.m in Sources */, + 05DF336E6DB67BB0621CCF0C9463ED4A /* IGListCollectionView.m in Sources */, + 0BC00DD25D3C4FF42C37433E81CA6F77 /* IGListCollectionViewLayout.mm in Sources */, + 2F0CA6E635295AA692FAEB9393783F4B /* IGListDebugger.m in Sources */, + DDA74D6EBFE54AC3941181507F8060AB /* IGListDebuggingUtilities.m in Sources */, + 1B17C9041C0794A94A39D5B31C62CEDE /* IGListDisplayHandler.m in Sources */, + C5814CF9B5EB63D89CBE27EE2A19520A /* IGListGenericSectionController.m in Sources */, + B707A3EC8581E09D0BA10908C235D401 /* IGListKit-dummy.m in Sources */, + 8500F9C0DFC843EB5A4ED4FF0664B213 /* IGListReloadDataUpdater.m in Sources */, + 86A6370F297F87A34ABC316470B564C3 /* IGListReloadIndexPath.m in Sources */, + B5E02A83F6C06F6D285E2EB1365A07BE /* IGListSectionController.m in Sources */, + 983C97E8D8F2AA85CAEDDB6D74EBA866 /* IGListSectionMap.m in Sources */, + CC2D622535AED6D39919BAAD8B55B828 /* IGListSectionMap+DebugDescription.m in Sources */, + DC576EBDA8822307BFAA01B1E07EB6B2 /* IGListSingleSectionController.m in Sources */, + C8E736F2681D5A47031328BE6DBAF0D6 /* IGListWorkingRangeHandler.mm in Sources */, + 194E2F707D9AE87266C08DDD38BAC2C5 /* UICollectionView+DebugDescription.m in Sources */, + 0C5C1FCD4460D91B069B29E4E4267EBF /* UICollectionView+IGListBatchUpdateData.m in Sources */, + ECFA80EB6B070B2B500F725449368B48 /* UICollectionViewLayout+InteractiveReordering.m in Sources */, + 6D3253DE7778CCCB009EFB375AA84800 /* UIScrollView+IGListKit.m in Sources */, + ); + runOnlyForDeploymentPostprocessing = 0; + }; +/* End PBXSourcesBuildPhase section */ + +/* Begin PBXTargetDependency section */ + 02CC40193B2425741A35E17204B03688 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + name = SwiftMessages; + target = DAB613A18652334F6BFC5F27BADF515D /* SwiftMessages */; + targetProxy = 800A33BC263765E54E7FBE37BFEC3000 /* PBXContainerItemProxy */; + }; + 0491256AEC27E3A33CE795014F28F2FD /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + name = "SwiftMessages-SwiftMessages"; + target = 93789445511E3FEAB3D09A6F552EEE2D /* SwiftMessages-SwiftMessages */; + targetProxy = 55802A5FB5EBEB01607325E334C83585 /* PBXContainerItemProxy */; + }; + 3C96041AF97B074F4C690C5C62A6368B /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + name = IGListKit; + target = 674FDCAB4D51E702521F4CD31807F659 /* IGListKit */; + targetProxy = 1B3792504F0EED9EE18F016548B44086 /* PBXContainerItemProxy */; + }; + 4AB106F6C169F1F7C5633FFC0EED5546 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + name = IGListDiffKit; + target = 2D07A05F514BF9C5434DAC907988C708 /* IGListDiffKit */; + targetProxy = 66837020B415409BD9EC27EC5943B9A9 /* PBXContainerItemProxy */; + }; + 5C0C1B16990CADEC6C388F5C3EE827D2 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + name = UIColor_Hex_Swift; + target = A0CA3B0841360687C00D0E48D3E4C1B9 /* UIColor_Hex_Swift */; + targetProxy = E2E98D973191FE598F2C7D4D813CDBD5 /* PBXContainerItemProxy */; + }; + D2B8578FFD713994A8FFF50F2D3EBFB8 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + name = IGListDiffKit; + target = 2D07A05F514BF9C5434DAC907988C708 /* IGListDiffKit */; + targetProxy = BECFFC24423DFC78A02F544B59390655 /* PBXContainerItemProxy */; + }; + DF5A26E717434EAE7445B6AA418E6781 /* PBXTargetDependency */ = { + isa = PBXTargetDependency; + name = Kingfisher; + target = E8022D22FAA6690B5E1C379C1BCE1491 /* Kingfisher */; + targetProxy = BD3BFF283976737AF4A31E0233395338 /* PBXContainerItemProxy */; + }; +/* End PBXTargetDependency section */ + +/* Begin XCBuildConfiguration section */ + 032EDA8C88F2E73BC059D28AB5720416 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 6DEBD199402AB8F5B24357217344B70B /* Pods-Bulletin.debug.xcconfig */; + buildSettings = { + ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = NO; + CLANG_ENABLE_OBJC_WEAK = NO; + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + INFOPLIST_FILE = "Target Support Files/Pods-Bulletin/Pods-Bulletin-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MACH_O_TYPE = staticlib; + MODULEMAP_FILE = "Target Support Files/Pods-Bulletin/Pods-Bulletin.modulemap"; + OTHER_LDFLAGS = ""; + OTHER_LIBTOOLFLAGS = ""; + PODS_ROOT = "$(SRCROOT)"; + PRODUCT_BUNDLE_IDENTIFIER = "org.cocoapods.${PRODUCT_NAME:rfc1034identifier}"; + PRODUCT_NAME = "$(TARGET_NAME:c99extidentifier)"; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + TARGETED_DEVICE_FAMILY = "1,2"; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Debug; + }; + 1B1FC92834E84FFF3F5F89754187D9C6 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9AA30AE820EDB8A30CFA77ED3357C1E5 /* IGListKit.release.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/IGListKit/IGListKit-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/IGListKit/IGListKit-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/IGListKit/IGListKit.modulemap"; + PRODUCT_MODULE_NAME = IGListKit; + PRODUCT_NAME = IGListKit; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Release; + }; + 2B9E26EAE2CD392AD762421F663075A1 /* Debug */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_ENABLE_OBJC_WEAK = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = dwarf; + ENABLE_STRICT_OBJC_MSGSEND = YES; + ENABLE_TESTABILITY = YES; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_DYNAMIC_NO_PIC = NO; + GCC_NO_COMMON_BLOCKS = YES; + GCC_OPTIMIZATION_LEVEL = 0; + GCC_PREPROCESSOR_DEFINITIONS = ( + "POD_CONFIGURATION_DEBUG=1", + "DEBUG=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE; + MTL_FAST_MATH = YES; + ONLY_ACTIVE_ARCH = YES; + PRODUCT_NAME = "$(TARGET_NAME)"; + STRIP_INSTALLED_PRODUCT = NO; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG; + SWIFT_OPTIMIZATION_LEVEL = "-Onone"; + SWIFT_VERSION = 5.0; + SYMROOT = "${SRCROOT}/../build"; + }; + name = Debug; + }; + 326089C1C11FB65356346DE055F5D586 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7DFA141F9E4B0E2D3D78DA1215079EE0 /* IGListKit.debug.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/IGListKit/IGListKit-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/IGListKit/IGListKit-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/IGListKit/IGListKit.modulemap"; + PRODUCT_MODULE_NAME = IGListKit; + PRODUCT_NAME = IGListKit; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Debug; + }; + 4A89754B2096AFF6713D0E1F5B788A0A /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 9E7573C529987F0DB86026FA9777B8C3 /* Pods-Bulletin.release.xcconfig */; + buildSettings = { + ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = NO; + CLANG_ENABLE_OBJC_WEAK = NO; + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + INFOPLIST_FILE = "Target Support Files/Pods-Bulletin/Pods-Bulletin-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MACH_O_TYPE = staticlib; + MODULEMAP_FILE = "Target Support Files/Pods-Bulletin/Pods-Bulletin.modulemap"; + OTHER_LDFLAGS = ""; + OTHER_LIBTOOLFLAGS = ""; + PODS_ROOT = "$(SRCROOT)"; + PRODUCT_BUNDLE_IDENTIFIER = "org.cocoapods.${PRODUCT_NAME:rfc1034identifier}"; + PRODUCT_NAME = "$(TARGET_NAME:c99extidentifier)"; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Release; + }; + 4AD2E4574C8421AB16CD302FDE0B41EA /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = A1B692CB750B2228127BCE50696B349C /* SwiftMessages.release.xcconfig */; + buildSettings = { + CODE_SIGNING_ALLOWED = NO; + CONFIGURATION_BUILD_DIR = "$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/SwiftMessages"; + IBSC_MODULE = SwiftMessages; + INFOPLIST_FILE = "Target Support Files/SwiftMessages/ResourceBundle-SwiftMessages-SwiftMessages-Info.plist"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + PRODUCT_NAME = SwiftMessages; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + TARGETED_DEVICE_FAMILY = "1,2"; + WRAPPER_EXTENSION = bundle; + }; + name = Release; + }; + 5748CEB3A27DF5D76974F97B6FDAFEB8 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 990E9245247EA175C5B3F06E3FD3ABEF /* UIColor_Hex_Swift.release.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.modulemap"; + PRODUCT_MODULE_NAME = UIColor_Hex_Swift; + PRODUCT_NAME = UIColor_Hex_Swift; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Release; + }; + 63FAF33E1C55B71A5F5A8B3CC8749F99 /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ALWAYS_SEARCH_USER_PATHS = NO; + CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED = YES; + CLANG_ANALYZER_NONNULL = YES; + CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE; + CLANG_CXX_LANGUAGE_STANDARD = "gnu++14"; + CLANG_CXX_LIBRARY = "libc++"; + CLANG_ENABLE_MODULES = YES; + CLANG_ENABLE_OBJC_ARC = YES; + CLANG_ENABLE_OBJC_WEAK = YES; + CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES; + CLANG_WARN_BOOL_CONVERSION = YES; + CLANG_WARN_COMMA = YES; + CLANG_WARN_CONSTANT_CONVERSION = YES; + CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES; + CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR; + CLANG_WARN_DOCUMENTATION_COMMENTS = YES; + CLANG_WARN_EMPTY_BODY = YES; + CLANG_WARN_ENUM_CONVERSION = YES; + CLANG_WARN_INFINITE_RECURSION = YES; + CLANG_WARN_INT_CONVERSION = YES; + CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES; + CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES; + CLANG_WARN_OBJC_LITERAL_CONVERSION = YES; + CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR; + CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES; + CLANG_WARN_RANGE_LOOP_ANALYSIS = YES; + CLANG_WARN_STRICT_PROTOTYPES = YES; + CLANG_WARN_SUSPICIOUS_MOVE = YES; + CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE; + CLANG_WARN_UNREACHABLE_CODE = YES; + CLANG_WARN__DUPLICATE_METHOD_MATCH = YES; + COPY_PHASE_STRIP = NO; + DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym"; + ENABLE_NS_ASSERTIONS = NO; + ENABLE_STRICT_OBJC_MSGSEND = YES; + GCC_C_LANGUAGE_STANDARD = gnu11; + GCC_NO_COMMON_BLOCKS = YES; + GCC_PREPROCESSOR_DEFINITIONS = ( + "POD_CONFIGURATION_RELEASE=1", + "$(inherited)", + ); + GCC_WARN_64_TO_32_BIT_CONVERSION = YES; + GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR; + GCC_WARN_UNDECLARED_SELECTOR = YES; + GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; + GCC_WARN_UNUSED_FUNCTION = YES; + GCC_WARN_UNUSED_VARIABLE = YES; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + MTL_ENABLE_DEBUG_INFO = NO; + MTL_FAST_MATH = YES; + PRODUCT_NAME = "$(TARGET_NAME)"; + STRIP_INSTALLED_PRODUCT = NO; + SWIFT_COMPILATION_MODE = wholemodule; + SWIFT_OPTIMIZATION_LEVEL = "-O"; + SWIFT_VERSION = 5.0; + SYMROOT = "${SRCROOT}/../build"; + }; + name = Release; + }; + 80CFF3701C30078A716619ED51F45BC5 /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = A1B692CB750B2228127BCE50696B349C /* SwiftMessages.release.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/SwiftMessages/SwiftMessages-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/SwiftMessages/SwiftMessages-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/SwiftMessages/SwiftMessages.modulemap"; + PRODUCT_MODULE_NAME = SwiftMessages; + PRODUCT_NAME = SwiftMessages; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Release; + }; + 980A58862D8A5086E2825CF9017AC8DD /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 7CB626D861306564520283F74F854D64 /* Kingfisher.debug.xcconfig */; + buildSettings = { + CLANG_ENABLE_OBJC_WEAK = NO; + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/Kingfisher/Kingfisher-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/Kingfisher/Kingfisher-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/Kingfisher/Kingfisher.modulemap"; + PRODUCT_MODULE_NAME = Kingfisher; + PRODUCT_NAME = Kingfisher; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Debug; + }; + A2CF0BE9EF01BC9B2AC0AF9538E6064D /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 1B08200E58B617675FE96006778840FB /* IGListDiffKit.release.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/IGListDiffKit/IGListDiffKit-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/IGListDiffKit/IGListDiffKit-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/IGListDiffKit/IGListDiffKit.modulemap"; + PRODUCT_MODULE_NAME = IGListDiffKit; + PRODUCT_NAME = IGListDiffKit; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Release; + }; + AE25B7B6AE679D7B14C8B4DA0C761220 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = FB85FA489CBC63454660B040F371269C /* SwiftMessages.debug.xcconfig */; + buildSettings = { + CODE_SIGNING_ALLOWED = NO; + CONFIGURATION_BUILD_DIR = "$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/SwiftMessages"; + IBSC_MODULE = SwiftMessages; + INFOPLIST_FILE = "Target Support Files/SwiftMessages/ResourceBundle-SwiftMessages-SwiftMessages-Info.plist"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + PRODUCT_NAME = SwiftMessages; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + TARGETED_DEVICE_FAMILY = "1,2"; + WRAPPER_EXTENSION = bundle; + }; + name = Debug; + }; + B2C89343EB7C202BAEE5FBED397500CA /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = FB85FA489CBC63454660B040F371269C /* SwiftMessages.debug.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/SwiftMessages/SwiftMessages-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/SwiftMessages/SwiftMessages-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/SwiftMessages/SwiftMessages.modulemap"; + PRODUCT_MODULE_NAME = SwiftMessages; + PRODUCT_NAME = SwiftMessages; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Debug; + }; + BFD9E4B58F44191AF73A3434AAF6831F /* Release */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = D2EC6A9540A860E7EDBF13CF404CB4B8 /* Kingfisher.release.xcconfig */; + buildSettings = { + CLANG_ENABLE_OBJC_WEAK = NO; + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/Kingfisher/Kingfisher-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/Kingfisher/Kingfisher-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/Kingfisher/Kingfisher.modulemap"; + PRODUCT_MODULE_NAME = Kingfisher; + PRODUCT_NAME = Kingfisher; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VALIDATE_PRODUCT = YES; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Release; + }; + D85716C223E93E25ED025609282EB63F /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = 650F2EE29CA64B40F86449904824F62E /* UIColor_Hex_Swift.debug.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 12.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.modulemap"; + PRODUCT_MODULE_NAME = UIColor_Hex_Swift; + PRODUCT_NAME = UIColor_Hex_Swift; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Debug; + }; + EA9F71EDF3D48AF084CE2EE37C3D16D2 /* Debug */ = { + isa = XCBuildConfiguration; + baseConfigurationReference = B3D3E8CEA6EB6B2960A1895BBFF73681 /* IGListDiffKit.debug.xcconfig */; + buildSettings = { + "CODE_SIGN_IDENTITY[sdk=appletvos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=iphoneos*]" = ""; + "CODE_SIGN_IDENTITY[sdk=watchos*]" = ""; + CURRENT_PROJECT_VERSION = 1; + DEFINES_MODULE = YES; + DYLIB_COMPATIBILITY_VERSION = 1; + DYLIB_CURRENT_VERSION = 1; + DYLIB_INSTALL_NAME_BASE = "@rpath"; + GCC_PREFIX_HEADER = "Target Support Files/IGListDiffKit/IGListDiffKit-prefix.pch"; + INFOPLIST_FILE = "Target Support Files/IGListDiffKit/IGListDiffKit-Info.plist"; + INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks"; + IPHONEOS_DEPLOYMENT_TARGET = 9.0; + LD_RUNPATH_SEARCH_PATHS = ( + "$(inherited)", + "@executable_path/Frameworks", + "@loader_path/Frameworks", + ); + MODULEMAP_FILE = "Target Support Files/IGListDiffKit/IGListDiffKit.modulemap"; + PRODUCT_MODULE_NAME = IGListDiffKit; + PRODUCT_NAME = IGListDiffKit; + SDKROOT = iphoneos; + SKIP_INSTALL = YES; + SWIFT_ACTIVE_COMPILATION_CONDITIONS = "$(inherited) "; + SWIFT_VERSION = 5.0; + TARGETED_DEVICE_FAMILY = "1,2"; + VERSIONING_SYSTEM = "apple-generic"; + VERSION_INFO_PREFIX = ""; + }; + name = Debug; + }; +/* End XCBuildConfiguration section */ + +/* Begin XCConfigurationList section */ + 124A39A4C3D1564DB02296737FECE89C /* Build configuration list for PBXNativeTarget "IGListDiffKit" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + EA9F71EDF3D48AF084CE2EE37C3D16D2 /* Debug */, + A2CF0BE9EF01BC9B2AC0AF9538E6064D /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 15F7B5F2389DC795EC831863F9DF95D5 /* Build configuration list for PBXNativeTarget "IGListKit" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 326089C1C11FB65356346DE055F5D586 /* Debug */, + 1B1FC92834E84FFF3F5F89754187D9C6 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 3EBF158ED6C977460E2094CBA2B9AFC1 /* Build configuration list for PBXNativeTarget "SwiftMessages-SwiftMessages" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + AE25B7B6AE679D7B14C8B4DA0C761220 /* Debug */, + 4AD2E4574C8421AB16CD302FDE0B41EA /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 4821239608C13582E20E6DA73FD5F1F9 /* Build configuration list for PBXProject "Pods" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 2B9E26EAE2CD392AD762421F663075A1 /* Debug */, + 63FAF33E1C55B71A5F5A8B3CC8749F99 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 4FD7C2B04E1FC5365718930ADC799D5C /* Build configuration list for PBXNativeTarget "SwiftMessages" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + B2C89343EB7C202BAEE5FBED397500CA /* Debug */, + 80CFF3701C30078A716619ED51F45BC5 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 61FD5F1D788300894E920658B01F90CA /* Build configuration list for PBXNativeTarget "Pods-Bulletin" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 032EDA8C88F2E73BC059D28AB5720416 /* Debug */, + 4A89754B2096AFF6713D0E1F5B788A0A /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + 69ACD8654734266A348C6FF68E734010 /* Build configuration list for PBXNativeTarget "Kingfisher" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + 980A58862D8A5086E2825CF9017AC8DD /* Debug */, + BFD9E4B58F44191AF73A3434AAF6831F /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; + E22B609ECAEFA85B75A98369FF2A6B24 /* Build configuration list for PBXNativeTarget "UIColor_Hex_Swift" */ = { + isa = XCConfigurationList; + buildConfigurations = ( + D85716C223E93E25ED025609282EB63F /* Debug */, + 5748CEB3A27DF5D76974F97B6FDAFEB8 /* Release */, + ); + defaultConfigurationIsVisible = 0; + defaultConfigurationName = Release; + }; +/* End XCConfigurationList section */ + }; + rootObject = BFDFE7DC352907FC980B868725387E98 /* Project object */; +} diff --git a/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/IGListDiffKit.xcscheme b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/IGListDiffKit.xcscheme new file mode 100644 index 0000000..8434c2e --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/IGListDiffKit.xcscheme @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/IGListKit.xcscheme b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/IGListKit.xcscheme new file mode 100644 index 0000000..6bae6f9 --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/IGListKit.xcscheme @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/Kingfisher.xcscheme b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/Kingfisher.xcscheme new file mode 100644 index 0000000..71b3f40 --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/Kingfisher.xcscheme @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/Pods-Bulletin.xcscheme b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/Pods-Bulletin.xcscheme new file mode 100644 index 0000000..9ca218a --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/Pods-Bulletin.xcscheme @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/SwiftMessages-SwiftMessages.xcscheme b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/SwiftMessages-SwiftMessages.xcscheme new file mode 100644 index 0000000..08e75a2 --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/SwiftMessages-SwiftMessages.xcscheme @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/SwiftMessages.xcscheme b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/SwiftMessages.xcscheme new file mode 100644 index 0000000..77630c6 --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/SwiftMessages.xcscheme @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/UIColor_Hex_Swift.xcscheme b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/UIColor_Hex_Swift.xcscheme new file mode 100644 index 0000000..c3da4ac --- /dev/null +++ b/Demo/Pods/Pods.xcodeproj/xcuserdata/daxeshnagar.xcuserdatad/xcschemes/UIColor_Hex_Swift.xcscheme @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/SwiftMessages/LICENSE.md b/Demo/Pods/SwiftMessages/LICENSE.md new file mode 100644 index 0000000..bced733 --- /dev/null +++ b/Demo/Pods/SwiftMessages/LICENSE.md @@ -0,0 +1,8 @@ +Copyright (c) 2016 SwiftKick Mobile LLC + + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/Demo/Pods/SwiftMessages/README.md b/Demo/Pods/SwiftMessages/README.md new file mode 100644 index 0000000..97e8374 --- /dev/null +++ b/Demo/Pods/SwiftMessages/README.md @@ -0,0 +1,387 @@ +# SwiftMessages + +[![Twitter: @TimothyMoose](https://img.shields.io/badge/contact-@TimothyMoose-blue.svg?style=flat)](https://twitter.com/TimothyMoose) +[![Version](https://img.shields.io/cocoapods/v/SwiftMessages.svg?style=flat)](http://cocoadocs.org/docsets/SwiftMessages) +[![License](https://img.shields.io/cocoapods/l/SwiftMessages.svg?style=flat)](http://cocoadocs.org/docsets/SwiftMessages) +[![Platform](https://img.shields.io/cocoapods/p/SwiftMessages.svg?style=flat)](http://cocoadocs.org/docsets/SwiftMessages) +[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) + +

+ +

+ +## Overview + +SwiftMessages is a very flexible view and view controller presentation library for iOS. + +Message views and view controllers can be displayed at the top, bottom, or center of the screen, or behind navigation bars and tab bars. There are interactive dismiss gestures including a fun, physics-based one. Multiple background dimming modes. And a lot more! + +In addition to the numerous configuration options, SwiftMessages provides several good-looking layouts and themes. But SwiftMessages is also designer-friendly, which means you can fully and easily customize the view: + +* Copy one of the included nib files into your project and change it. +* Subclass `MessageView` and add elements, etc. +* Or just supply an arbitrary instance of `UIView`. + +Try exploring [the demo app via appetize.io](http://goo.gl/KXw4nD) to get a feel for the extensive configurability of SwiftMessages. + +

+ +

+ +

+ +

+ +## View Controllers + +SwiftMessages can present view controllers using the `SwiftMessagesSegue` custom modal segue! + +

+ +

+ +[`SwiftMessagesSegue`](./SwiftMessages/SwiftMessagesSegue.swift) is a subclass of `UIStoryboardSegue` that integrates directly into Interface Builder as a custom modal segue, enabling view controllers to take advantage of SwiftMessages layouts, animations and more. `SwiftMessagesSegue` works with any UIKIt project — storyboards are not required. Refer to the View Controllers readme below for more information. + +#### [View Controllers Readme](./ViewControllers.md) + +And check out our blog post [Elegant Custom UIViewController Transitioning](http://www.swiftkickmobile.com/elegant-custom-uiviewcontroller-transitioning-uiviewcontrollertransitioningdelegate-uiviewcontrolleranimatedtransitioning/) to learn a great technique you can use to build your own custom segues that utilize `UIViewControllerTransitioningDelegate` and `UIViewControllerAnimatedTransitioning`. + +## Installation + +### Swift Package Manager + +Go to `File | Swift Packages | Add Package Dependency...` in Xcode and search for "SwiftMessages". If multiple results are found, select the one owned by SwiftKick Mobile. + +### CocoaPods + +Add the following line to your Podfile: + +````ruby +pod 'SwiftMessages' +```` + +### Carthage + +Add the following line to your Cartfile: + +````ruby +github "SwiftKickMobile/SwiftMessages" +```` + +If the Carthage build fails, [try using the script](https://github.com/Carthage/Carthage/issues/3019). + +### Manual + +1. Put SwiftMessages repo somewhere in your project directory. +1. In Xcode, add `SwiftMessages.xcodeproj` to your project. +1. On your app's target, add the SwiftMessages framework: + 1. as an embedded binary on the General tab. + 1. as a target dependency on the Build Phases tab. + +## Usage + +### Basics + +````swift +SwiftMessages.show(view: myView) +```` + +Although you can show any instance of `UIView`, SwiftMessages provides a `MessageView` class +and assortment of nib-based layouts that should handle most cases: + +````swift +// Instantiate a message view from the provided card view layout. SwiftMessages searches for nib +// files in the main bundle first, so you can easily copy them into your project and make changes. +let view = MessageView.viewFromNib(layout: .cardView) + +// Theme message elements with the warning style. +view.configureTheme(.warning) + +// Add a drop shadow. +view.configureDropShadow() + +// Set message title, body, and icon. Here, we're overriding the default warning +// image with an emoji character. +let iconText = ["🤔", "😳", "🙄", "😶"].randomElement()! +view.configureContent(title: "Warning", body: "Consider yourself warned.", iconText: iconText) + +// Increase the external margin around the card. In general, the effect of this setting +// depends on how the given layout is constrained to the layout margins. +view.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) + +// Reduce the corner radius (applicable to layouts featuring rounded corners). +(view.backgroundView as? CornerRoundingView)?.cornerRadius = 10 + +// Show the message. +SwiftMessages.show(view: view) +```` + +You may wish to use the view provider variant `show(viewProvider:)` to ensure that +your UIKit code is executed on the main queue: + +````swift +SwiftMessages.show { + let view = MessageView.viewFromNib(layout: .cardView) + // ... configure the view + return view +} +```` + +The `SwiftMessages.Config` struct provides numerous configuration options that can be passed to `show()`: + +````swift +var config = SwiftMessages.Config() + +// Slide up from the bottom. +config.presentationStyle = .bottom + +// Display in a window at the specified window level. +config.presentationContext = .window(windowLevel: .statusBar) + +Note that, as of iOS 13, it is no longer possible to cover the status bar +regardless of the window level. A workaround is to hide the status bar instead. +config.prefersStatusBarHidden = true + +// Disable the default auto-hiding behavior. +config.duration = .forever + +// Dim the background like a popover view. Hide when the background is tapped. +config.dimMode = .gray(interactive: true) + +// Disable the interactive pan-to-hide gesture. +config.interactiveHide = false + +// Specify a status bar style to if the message is displayed directly under the status bar. +config.preferredStatusBarStyle = .lightContent + +// Specify one or more event listeners to respond to show and hide events. +config.eventListeners.append() { event in + if case .didHide = event { + print("yep id=\(String(describing: event.id)") + } +} + +SwiftMessages.show(config: config, view: view) +```` + +Specify default configuration options: + +````swift +SwiftMessages.defaultConfig.presentationStyle = .bottom + +// Show message with default config. +SwiftMessages.show(view: view) + +// Customize config using the default as a base. +var config = SwiftMessages.defaultConfig +config.duration = .forever +SwiftMessages.show(config: config, view: view) +```` + +### Accessibility + +SwiftMessages provides excellent VoiceOver support out-of-the-box. + +* The title and body of the message are combined into a single announcement when the message is shown. The `MessageView.accessibilityPrefix` property can be set to prepend additional clarifying text to the announcement. + + Sometimes, a message may contain important visual cues that aren't captured in the title or body. For example, a message may rely on a yellow background to convey a warning rather than having the word "warning" in the title or body. In this case, it might be helpful to set `MessageView.accessibilityPrefix = "warning"`. + +* If the message is shown with a dim view using `config.dimMode`, elements below the dim view are not focusable until the message is hidden. If `config.dimMode.interactive == true`, the dim view itself will be focusable and read out "dismiss" followed by "button". The former text can be customized by setting the `config.dimModeAccessibilityLabel` property. + +See the `AccessibleMessage` protocol for implementing proper accessibility support in custom views. + +### Keyboard Avoidance + +The `KeyboardTrackingView` class can be used to cause the message view to avoid the keyboard by sliding up when the keyboard gets too close. + +````swift +var config = SwiftMessages.defaultConfig +config.keyboardTrackingView = KeyboardTrackingView() +```` + +You can incorporate `KeyboardTrackingView` into your app even when you're not using SwiftMessages. Install into your view hierarchy by pinning `KeyboardTrackingView` to the bottom, leading, and trailing edges of the screen. Then pin the bottom of your content that should avoid the keyboard to the top `KeyboardTrackingView`. Use an equality constraint to strictly track the keyboard or an inequality constraint to only move when the keyboard gets too close. `KeyboardTrackingView` works by observing keyboard notifications and adjusting its height to maintain its top edge above the keyboard, thereby pushing your content up. See the comments in `KeyboardTrackingView` for configuration options. + +### Message Queueing + +You can call `SwiftMessages.show()` as many times as you like. SwiftMessages maintains a queue and shows messages one at a time. If your view implements the `Identifiable` protocol (like `MessageView`), duplicate messages will be removed automatically. The pause between messages can be adjusted: + +````swift +SwiftMessages.pauseBetweenMessages = 1.0 +```` + +There are a few ways to hide messages programatically: + +````swift +// Hide the current message. +SwiftMessages.hide() + +// Or hide the current message and clear the queue. +SwiftMessages.hideAll() + +// Or for a view that implements `Identifiable`: +SwiftMessages.hide(id: someId) + +// Or hide when the number of calls to show() and hideCounted(id:) for a +// given message ID are equal. This can be useful for messages that may be +// shown from multiple code paths to ensure that all paths are ready to hide. +SwiftMessages.hideCounted(id: someId) +```` + +Multiple instances of `SwiftMessages` can be used to show more than one message at a time. Note that the static `SwiftMessages.show()` and other static APIs on `SwiftMessage` are just convenience wrappers around the shared instance `SwiftMessages.sharedInstance`). Instances must be retained, thus it should be a property of something (e.g. your view controller): + +````swift +class SomeViewController: UIViewController { + let otherMessages = SwiftMessages() + + func someMethod() { + SwiftMessages.show(...) + otherMessages.show(...) + } +} +```` + +### Retrieving Messages + +There are several APIs available for retrieving messages that are currently being shown, hidden, or queued to be shown. These APIs are useful for updating messages +when some event happens without needing to keep temporary references around. +See also `eventListeners`. + +````swift +// Get a message view with the given ID if it is currently +// being shown or hidden. +if let view = SwiftMessages.current(id: "some id") { ... } + +// Get a message view with the given ID if is it currently +// queued to be shown. +if let view = SwiftMessages.queued(id: "some id") { ... } + +// Get a message view with the given ID if it is currently being +// shown, hidden or in the queue to be shown. +if let view = SwiftMessages.currentOrQueued(id: "some id") { ... } +```` + +### Customization + +SwiftMessages can display any `UIView`. However, there are varying degrees of customization that can be done to the bundled views. + +#### Nib Files + +All of the message designs bundled with SwiftMessages have associated nib files. You are encouraged to copy any of these nib files into your project and modify them to suit your needs. SwiftMessages will load your copy of the file instead of the original. Nib files may be copied in Xcode using drag-and-drop. + +To facilitate the use of nib-based layouts, `MessageView` provides some type-safe convenience methods for loading the bundled nibs: + +````swift +let view = MessageView.viewFromNib(layout: .cardView) +```` + +In addition, the `SwiftMessages` class provides some generic loading methods: + +````swift +// Instantiate MessageView from a named nib. +let view: MessageView = try! SwiftMessages.viewFromNib(named: "MyCustomNib") + +// Instantiate MyCustomView from a nib named MyCustomView.nib. +let view: MyCustomView = try! SwiftMessages.viewFromNib() +```` + +#### MessageView Class + + +[`MessageView`](./SwiftMessages/MessageView.swift) is a light-weight view that all of the bundled designs use. It primarily consists of the following optional `@IBOutlet` properties: + +Element | Declaration | Description +--------|-----------|----- +Title | `titleLabel: UILabel?` | The message title. +Message body | `bodyLabel: UILabel?` | The body of the message. +Image icon | `iconImageView: UIImageView?` | An image-based icon. +Text icon | `iconLabel: UILabel?` | A text-based (emoji) alternative to the image icon. +Button | `button: UIButton?` | An action button. + +The SwiftMessages nib file use `MessageView` as the top-level view with content connected to these outlets. The layouts are done using stack views, which means that you can remove an element by simply hiding it: + +````swift +view.titleLabel.isHidden = true +```` + +A common mistake is attempting to remove an element by setting the corresponding outlet to `nil`. This does not work because it does not remove the element from the view hierarchy. + +#### Configuration + +`MessageView` provides numerous methods that follow the `configure*` naming convention: + +````swift +view.configureTheme(.warning) +view.configureContent(title: "Warning", body: "Consider yourself warned.", iconText: "🤔") +```` + +All of these methods are shortcuts for quickly configuring the underlying view properties. SwiftMessages strives to avoid doing any internal magic in these methods, so you do not need to call them. You can configure the view properties directly or combine the two approaches. + +#### Interaction + +`MessageView` provides an optional block-based tap handler for the button and another for the view itself: + +````swift +// Hide when button tapped +messageView.buttonTapHandler = { _ in SwiftMessages.hide() } + +// Hide when message view tapped +messageView.tapHandler = { _ in SwiftMessages.hide() } +```` + +#### Extending + +The suggested method for starting with `MessageView` as a base and __adding new elements__, such as additional buttons, is as follows: + + 1. Copy one of the bundled nib files into your project or create a new one from scratch. + 1. Add new elements to the nib file. + 1. Sublcass `MessageView` and create outlets for the new elements. + 1. Assign the top-level view in the nib file to the subclass. + 1. Connect outlets between the nib file and the subclass. + 1. (recommended) override the implementation of `Identifiable` as needed to incorporate new elements into the message's identity. + 1. (recommended) override the implementation of `AccessibleMessage` as needed to incorporate new elements into Voice Over. + 1. Use one of the nib-loading methods above to load the view. + +#### BaseView Class + +[`BaseView`](./SwiftMessages/BaseView.swift) is the superclass of `MessageView` and provides numerous options that aren't specific to the "title + body + icon + button" design of `MessageView`. Custom views that are significantly different from `MessageView`, such as a progress indicator, should subclass `BaseView`. + +#### CornerRoundingView Class + +[`CornerRoundingView`](./SwiftMessages/CornerRoundingView.swift) is a custom view that messages can use for rounding all or a subset of corners with squircles (the smoother method of rounding corners that you see on app icons). The nib files that feature rounded corners have `backgroundView` assigned to a `CornerRoundingView`. It provides a `roundsLeadingCorners` option to dynamically round only the leading corners of the view when presented from top or bottom (a feature used for the tab-style layouts). + +#### Animator Protocol + +[`Animator`](./SwiftMessages/Animator.swift) is the protocol that SwiftMessages uses for presentation and dismissal animations. Custom animations can be done through the `SwiftMessages.PresentationStyle.custom(animator:)`. Some related components: +* [`TopBottomAnimation`](./SwiftMessages/TopBottomAnimation.swift) is a sliding implementation of `Animator` used internally by `.top` and `.bottom` presentation styles. It provides some customization options. +* [`PhysicsAnimation`](./SwiftMessages/PhysicsAnimation.swift) is a scaling + opacity implementation of `Animator` used internally by the `.center` presentation style. It provides a fun physics-based dismissal gesture and provides customization options including `.top` and `.bottom` placement. +* [`PhysicsPanHandler`](./SwiftMessages/PhysicsPanHandler.swift) provides the physics-based dismissal gesture for `PhysicsAnimation` and can be incorporated into other `Animator` implementations. + +High-quality PRs for cool `Animator` implementations are welcome! + +#### MarginAdjustable Protocol + +[`MarginAdjustable`](./SwiftMessages/MarginAdjustable.swift) is a protocol adopted by `BaseView`. If the view being presented adopts `MarginAdjustable`, SwiftMessages takes ownership of the view's layout margins to ensure ideal spacing across the full range of presentation contexts. + +#### BackgroundViewable Protocol + +[`BackgroundViewable`](./SwiftMessages/BackgroundViewable.swift) is a protocol adopted by `BaseView` and requires that a view provide a single `backgroundView` property. `BaseView` initializes `backgroundView = self`, which you can freely re-assign to any subview. + +If the view being presented adopts `BackgroundViewable`, SwiftMessages will ignore touches outside of `backgroundView`. This is important because message views always span the full width of the device. Card and tab-style layouts appear inset from the edges of the device because the message view's background is transparent and `backgroundView` is assigned to a subview constrained to the layout margins. In these layouts, touches in the transparent margins should be ignored. + +#### Identifiable Protocol + +[`Identifiable`](./SwiftMessages/Identifiable.swift) is a protocol adopted by `MessageView` and requires that a view provide a single `id` property, which SwiftMessages uses for message deduplication. + +`MessageView` computes the `id` based on the message content, but `id` can also be set explicitly as needed. + +#### AccessibleMessage Protocol + +[`AccessibleMessage`](./SwiftMessages/AccessibleMessage.swift) is a protocol adopted by `MessageView`. If the view being presented adopts `AccessibleMessage`, SwiftMessages provides improved Voice Over. + + +## About SwiftKick Mobile +We build high quality apps! [Get in touch](http://www.swiftkickmobile.com) if you need help with a project. + +## License + +SwiftMessages is distributed under the MIT license. [See LICENSE](./LICENSE.md) for details. diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/AccessibleMessage.swift b/Demo/Pods/SwiftMessages/SwiftMessages/AccessibleMessage.swift new file mode 100644 index 0000000..d540ece --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/AccessibleMessage.swift @@ -0,0 +1,20 @@ +// +// AccessibleMessage.swift +// SwiftMessages +// +// Created by Timothy Moose on 3/11/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import Foundation + +/** + Message views that `AccessibleMessage`, as `MessageView` does will + have proper accessibility behavior when displaying messages. + `MessageView` implements this protocol. + */ +public protocol AccessibleMessage { + var accessibilityMessage: String? { get } + var accessibilityElement: NSObject? { get } + var additionalAccessibilityElements: [NSObject]? { get } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Animator.swift b/Demo/Pods/SwiftMessages/SwiftMessages/Animator.swift new file mode 100644 index 0000000..8207406 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Animator.swift @@ -0,0 +1,78 @@ +// +// Animator.swift +// SwiftMessages +// +// Created by Timothy Moose on 6/4/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +public typealias AnimationCompletion = (_ completed: Bool) -> Void + +public protocol AnimationDelegate: AnyObject { + func hide(animator: Animator) + func panStarted(animator: Animator) + func panEnded(animator: Animator) +} + +/** + An option set representing the known types of safe area conflicts + that could require margin adjustments on the message view in order to + get the layouts to look right. + */ +public struct SafeZoneConflicts: OptionSet { + public let rawValue: Int + + public init(rawValue: Int) { + self.rawValue = rawValue + } + + /// Message view behind status bar + public static let statusBar = SafeZoneConflicts(rawValue: 1 << 0) + + /// Message view behind the sensor notch on iPhone X + public static let sensorNotch = SafeZoneConflicts(rawValue: 1 << 1) + + /// Message view behind home indicator on iPhone X + public static let homeIndicator = SafeZoneConflicts(rawValue: 1 << 2) + + /// Message view is over the status bar on an iPhone 8 or lower. This is a special + /// case because we logically expect the top safe area to be zero, but it is reported as 20 + /// (which seems like an iOS bug). We use the `overStatusBar` to indicate this special case. + public static let overStatusBar = SafeZoneConflicts(rawValue: 1 << 3) +} + +public class AnimationContext { + + public let messageView: UIView + public let containerView: UIView + public let safeZoneConflicts: SafeZoneConflicts + public let interactiveHide: Bool + + init(messageView: UIView, containerView: UIView, safeZoneConflicts: SafeZoneConflicts, interactiveHide: Bool) { + self.messageView = messageView + self.containerView = containerView + self.safeZoneConflicts = safeZoneConflicts + self.interactiveHide = interactiveHide + } +} + +public protocol Animator: AnyObject { + + /// Adopting classes should declare as `weak`. + var delegate: AnimationDelegate? { get set } + + func show(context: AnimationContext, completion: @escaping AnimationCompletion) + + func hide(context: AnimationContext, completion: @escaping AnimationCompletion) + + /// The show animation duration. If the animation duration is unknown, such as if using `UIDynamicAnimator`, + /// then provide an estimate. This value is used by `SwiftMessagesSegue`. + var showDuration: TimeInterval { get } + + /// The hide animation duration. If the animation duration is unknown, such as if using `UIDynamicAnimator`, + /// then provide an estimate. This value is used by `SwiftMessagesSegue`. + var hideDuration: TimeInterval { get } +} + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/BackgroundViewable.swift b/Demo/Pods/SwiftMessages/SwiftMessages/BackgroundViewable.swift new file mode 100644 index 0000000..1c47036 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/BackgroundViewable.swift @@ -0,0 +1,24 @@ +// +// BackgroundViewable.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/15/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +/** + Message views that implement the `BackgroundViewable` protocol will have the + pan-to-hide gesture recognizer installed in the `backgroundView`. Message views + always span the full width of the containing view. Typically, the `backgroundView` + property defines the message view's visible region, allowing for card-style views + where the message view background is transparent and the background view is inset + from by some amount. See CardView.nib, for example. + + This protocol is optional. Message views that don't implement `BackgroundViewable` + will have the pan-to-hide gesture installed in the message view itself. + */ +public protocol BackgroundViewable { + var backgroundView: UIView! { get } +} \ No newline at end of file diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/BaseView.swift b/Demo/Pods/SwiftMessages/SwiftMessages/BaseView.swift new file mode 100644 index 0000000..9480b87 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/BaseView.swift @@ -0,0 +1,375 @@ + +// +// BaseView.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/17/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +/** + The `BaseView` class is a reusable message view base class that implements some + of the optional SwiftMessages protocols and provides some convenience functions + and a configurable tap handler. Message views do not need to inherit from `BaseVew`. + */ +open class BaseView: UIView, BackgroundViewable, MarginAdjustable { + + /* + MARK: - IB outlets + */ + + /** + Fulfills the `BackgroundViewable` protocol and is the target for + the optional `tapHandler` block. Defaults to `self`. + */ + @IBOutlet open weak var backgroundView: UIView! { + didSet { + if let old = oldValue { + old.removeGestureRecognizer(tapRecognizer) + } + installTapRecognizer() + updateBackgroundHeightConstraint() + } + } + + // The `contentView` property was removed because it no longer had any functionality + // in the framework. This is a minor backwards incompatible change. If you've copied + // one of the included nib files from a previous release, you may get a key-value + // coding runtime error related to contentView, in which case you can subclass the + // view and add a `contentView` property or you can remove the outlet connection in + // Interface Builder. + // @IBOutlet public var contentView: UIView! + + /* + MARK: - Initialization + */ + + public required init?(coder aDecoder: NSCoder) { + super.init(coder: aDecoder) + backgroundView = self + layoutMargins = UIEdgeInsets.zero + } + + public override init(frame: CGRect) { + super.init(frame: frame) + backgroundView = self + layoutMargins = UIEdgeInsets.zero + } + + /* + MARK: - Installing background and content + */ + + /** + A convenience function for installing a content view as a subview of `backgroundView` + and pinning the edges to `backgroundView` with the specified `insets`. + + - Parameter contentView: The view to be installed into the background view + and assigned to the `contentView` property. + - Parameter insets: The amount to inset the content view from the background view. + Default is zero inset. + */ + open func installContentView(_ contentView: UIView, insets: UIEdgeInsets = UIEdgeInsets.zero) { + contentView.translatesAutoresizingMaskIntoConstraints = false + backgroundView.addSubview(contentView) + contentView.topAnchor.constraint(equalTo: backgroundView.topAnchor, constant: insets.top).isActive = true + contentView.bottomAnchor.constraint(equalTo: backgroundView.bottomAnchor, constant: -insets.bottom).isActive = true + contentView.leftAnchor.constraint(equalTo: backgroundView.leftAnchor, constant: insets.left).isActive = true + contentView.rightAnchor.constraint(equalTo: backgroundView.rightAnchor, constant: -insets.right).isActive = true + contentView.heightAnchor.constraint(equalToConstant: 350).with(priority: UILayoutPriority(rawValue: 200)).isActive = true + } + + /** + A convenience function for installing a background view and pinning to the layout margins. + This is useful for creating programatic layouts where the background view needs to be + inset from the message view's edges (like a card-style layout). + + - Parameter backgroundView: The view to be installed as a subview and + assigned to the `backgroundView` property. + - Parameter insets: The amount to inset the content view from the margins. Default is zero inset. + */ + open func installBackgroundView(_ backgroundView: UIView, insets: UIEdgeInsets = UIEdgeInsets.zero) { + backgroundView.translatesAutoresizingMaskIntoConstraints = false + if backgroundView != self { + backgroundView.removeFromSuperview() + } + addSubview(backgroundView) + self.backgroundView = backgroundView + backgroundView.centerXAnchor.constraint(equalTo: centerXAnchor).with(priority: UILayoutPriority(rawValue: 950)).isActive = true + backgroundView.topAnchor.constraint(equalTo: layoutMarginsGuide.topAnchor, constant: insets.top).with(priority: UILayoutPriority(rawValue: 900)).isActive = true + backgroundView.bottomAnchor.constraint(equalTo: layoutMarginsGuide.bottomAnchor, constant: -insets.bottom).with(priority: UILayoutPriority(rawValue: 900)).isActive = true + backgroundView.heightAnchor.constraint(equalToConstant: 350).with(priority: UILayoutPriority(rawValue: 200)).isActive = true + layoutConstraints = [ + backgroundView.leftAnchor.constraint(equalTo: layoutMarginsGuide.leftAnchor, constant: insets.left).with(priority: UILayoutPriority(rawValue: 900)), + backgroundView.rightAnchor.constraint(equalTo: layoutMarginsGuide.rightAnchor, constant: -insets.right).with(priority: UILayoutPriority(rawValue: 900)), + ] + regularWidthLayoutConstraints = [ + backgroundView.leftAnchor.constraint(greaterThanOrEqualTo: layoutMarginsGuide.leftAnchor, constant: insets.left).with(priority: UILayoutPriority(rawValue: 900)), + backgroundView.rightAnchor.constraint(lessThanOrEqualTo: layoutMarginsGuide.rightAnchor, constant: -insets.right).with(priority: UILayoutPriority(rawValue: 900)), + backgroundView.widthAnchor.constraint(lessThanOrEqualToConstant: 500).with(priority: UILayoutPriority(rawValue: 950)), + backgroundView.widthAnchor.constraint(equalToConstant: 500).with(priority: UILayoutPriority(rawValue: 200)), + ] + installTapRecognizer() + } + + /** + A convenience function for installing a background view and pinning to the horizontal + layout margins and to the vertical edges. This is useful for creating programatic layouts where + the background view needs to be inset from the message view's horizontal edges (like a tab-style layout). + + - Parameter backgroundView: The view to be installed as a subview and + assigned to the `backgroundView` property. + - Parameter insets: The amount to inset the content view from the horizontal margins and vertical edges. + Default is zero inset. + */ + open func installBackgroundVerticalView(_ backgroundView: UIView, insets: UIEdgeInsets = UIEdgeInsets.zero) { + backgroundView.translatesAutoresizingMaskIntoConstraints = false + if backgroundView != self { + backgroundView.removeFromSuperview() + } + addSubview(backgroundView) + self.backgroundView = backgroundView + backgroundView.centerXAnchor.constraint(equalTo: centerXAnchor).with(priority: UILayoutPriority(rawValue: 950)).isActive = true + backgroundView.topAnchor.constraint(equalTo: topAnchor, constant: insets.top).with(priority: UILayoutPriority(rawValue: 1000)).isActive = true + backgroundView.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -insets.bottom).with(priority: UILayoutPriority(rawValue: 1000)).isActive = true + backgroundView.heightAnchor.constraint(equalToConstant: 350).with(priority: UILayoutPriority(rawValue: 200)).isActive = true + layoutConstraints = [ + backgroundView.leftAnchor.constraint(equalTo: layoutMarginsGuide.leftAnchor, constant: insets.left).with(priority: UILayoutPriority(rawValue: 900)), + backgroundView.rightAnchor.constraint(equalTo: layoutMarginsGuide.rightAnchor, constant: -insets.right).with(priority: UILayoutPriority(rawValue: 900)), + ] + regularWidthLayoutConstraints = [ + backgroundView.leftAnchor.constraint(greaterThanOrEqualTo: layoutMarginsGuide.leftAnchor, constant: insets.left).with(priority: UILayoutPriority(rawValue: 900)), + backgroundView.rightAnchor.constraint(lessThanOrEqualTo: layoutMarginsGuide.rightAnchor, constant: -insets.right).with(priority: UILayoutPriority(rawValue: 900)), + backgroundView.widthAnchor.constraint(lessThanOrEqualToConstant: 500).with(priority: UILayoutPriority(rawValue: 950)), + backgroundView.widthAnchor.constraint(equalToConstant: 500).with(priority: UILayoutPriority(rawValue: 200)), + ] + installTapRecognizer() + } + + /* + MARK: - Tap handler + */ + + /** + An optional tap handler that will be called when the `backgroundView` is tapped. + */ + open var tapHandler: ((_ view: BaseView) -> Void)? { + didSet { + installTapRecognizer() + } + } + + fileprivate lazy var tapRecognizer: UITapGestureRecognizer = { + let tapRecognizer = UITapGestureRecognizer(target: self, action: #selector(MessageView.tapped)) + return tapRecognizer + }() + + @objc func tapped() { + tapHandler?(self) + } + + fileprivate func installTapRecognizer() { + guard let backgroundView = backgroundView else { return } + removeGestureRecognizer(tapRecognizer) + backgroundView.removeGestureRecognizer(tapRecognizer) + if tapHandler != nil { + // Only install the tap recognizer if there is a tap handler, + // which makes it slightly nicer if one wants to install + // a custom gesture recognizer. + backgroundView.addGestureRecognizer(tapRecognizer) + } + } + + open override func point(inside point: CGPoint, with event: UIEvent?) -> Bool { + if backgroundView != self { + let backgroundViewPoint = convert(point, to: backgroundView) + return backgroundView.point(inside: backgroundViewPoint, with: event) + } + return super.point(inside: point, with: event) + } + + /* + MARK: - MarginAdjustable + + These properties fulfill the `MarginAdjustable` protocol and are exposed + as `@IBInspectables` so that they can be adjusted directly in nib files + (see MessageView.nib). + */ + + public var layoutMarginAdditions: UIEdgeInsets { + get { + return UIEdgeInsets(top: topLayoutMarginAddition, left: leftLayoutMarginAddition, bottom: bottomLayoutMarginAddition, right: rightLayoutMarginAddition) + } + set { + topLayoutMarginAddition = newValue.top + leftLayoutMarginAddition = newValue.left + bottomLayoutMarginAddition = newValue.bottom + rightLayoutMarginAddition = newValue.right + } + } + + /// Start margins from the safe area. + open var respectSafeArea: Bool = true + + /// IBInspectable access to layoutMarginAdditions.top + @IBInspectable open var topLayoutMarginAddition: CGFloat = 0 + + /// IBInspectable access to layoutMarginAdditions.left + @IBInspectable open var leftLayoutMarginAddition: CGFloat = 0 + + /// IBInspectable access to layoutMarginAdditions.bottom + @IBInspectable open var bottomLayoutMarginAddition: CGFloat = 0 + + /// IBInspectable access to layoutMarginAdditions.right + @IBInspectable open var rightLayoutMarginAddition: CGFloat = 0 + + @IBInspectable open var collapseLayoutMarginAdditions: Bool = true + + @IBInspectable open var bounceAnimationOffset: CGFloat = 5 + + /* + MARK: - Setting the height + */ + + /** + An optional explicit height for the background view, which can be used if + the message view's intrinsic content size does not produce the desired height. + */ + open var backgroundHeight: CGFloat? { + didSet { + updateBackgroundHeightConstraint() + } + } + + private func updateBackgroundHeightConstraint() { + if let existing = backgroundHeightConstraint { + let view = existing.firstItem as! UIView + view.removeConstraint(existing) + backgroundHeightConstraint = nil + } + if let height = backgroundHeight, let backgroundView = backgroundView { + let constraint = NSLayoutConstraint(item: backgroundView, attribute: .height, relatedBy: .equal, toItem: nil, attribute: .notAnAttribute, multiplier: 1, constant: height) + backgroundView.addConstraint(constraint) + backgroundHeightConstraint = constraint + } + } + + private var backgroundHeightConstraint: NSLayoutConstraint? + + /* + Mark: - Layout + */ + + open override func updateConstraints() { + super.updateConstraints() + let on: [NSLayoutConstraint] + let off: [NSLayoutConstraint] + switch traitCollection.horizontalSizeClass { + case .regular: + on = regularWidthLayoutConstraints + off = layoutConstraints + default: + on = layoutConstraints + off = regularWidthLayoutConstraints + } + on.forEach { $0.isActive = true } + off.forEach { $0.isActive = false } + } + + private var layoutConstraints: [NSLayoutConstraint] = [] + private var regularWidthLayoutConstraints: [NSLayoutConstraint] = [] +} + +/* + MARK: - Theming + */ + +extension BaseView { + + /// A convenience function to configure a default drop shadow effect. + /// The shadow is to this view's layer instead of that of the background view + /// because the background view may be masked. So, when modifying the drop shadow, + /// be sure to set the shadow properties of this view's layer. The shadow path is + /// updated for you automatically. + open func configureDropShadow() { + layer.shadowColor = UIColor.black.cgColor + layer.shadowOffset = CGSize(width: 0.0, height: 2.0) + layer.shadowRadius = 6.0 + layer.shadowOpacity = 0.4 + layer.masksToBounds = false + updateShadowPath() + } + + /// A convenience function to turn off drop shadow + open func configureNoDropShadow() { + layer.shadowOpacity = 0 + } + + private func updateShadowPath() { + backgroundView?.layoutIfNeeded() + let shadowLayer = backgroundView?.layer ?? layer + let shadowRect = layer.convert(shadowLayer.bounds, from: shadowLayer) + let shadowPath: CGPath? + if let backgroundMaskLayer = shadowLayer.mask as? CAShapeLayer, + let backgroundMaskPath = backgroundMaskLayer.path { + var transform = CGAffineTransform(translationX: shadowRect.minX, y: shadowRect.minY) + shadowPath = backgroundMaskPath.copy(using: &transform) + } else { + shadowPath = UIBezierPath(roundedRect: shadowRect, cornerRadius: shadowLayer.cornerRadius).cgPath + } + // This is a workaround needed for smooth rotation animations. + if let foundAnimation = layer.findAnimation(forKeyPath: "bounds.size") { + // Update the layer's `shadowPath` with animation, copying the relevant properties + // from the found animation. + let animation = CABasicAnimation(keyPath: "shadowPath") + animation.duration = foundAnimation.duration + animation.timingFunction = foundAnimation.timingFunction + animation.fromValue = layer.shadowPath + animation.toValue = shadowPath + layer.add(animation, forKey: "shadowPath") + layer.shadowPath = shadowPath + } else { + // Update the layer's `shadowPath` without animation + layer.shadowPath = shadowPath } + } + + open override func layoutSubviews() { + super.layoutSubviews() + updateShadowPath() + } +} + +/* + MARK: - Configuring the width + + This extension provides a few convenience functions for configuring the + background view's width. You are encouraged to write your own such functions + if these don't exactly meet your needs. + */ + +extension BaseView { + + /** + A shortcut for configuring the left and right layout margins. For views that + have `backgroundView` as a subview of `MessageView`, the background view should + be pinned to the left and right `layoutMargins` in order for this configuration to work. + */ + public func configureBackgroundView(sideMargin: CGFloat) { + layoutMargins.left = sideMargin + layoutMargins.right = sideMargin + } + + /** + A shortcut for adding a width constraint to the `backgroundView`. When calling this + method, it is important to ensure that the width constraint doesn't conflict with + other constraints. The CardView.nib and TabView.nib layouts are compatible with + this method. + */ + public func configureBackgroundView(width: CGFloat) { + guard let backgroundView = backgroundView else { return } + let constraint = NSLayoutConstraint(item: backgroundView, attribute: .width, relatedBy: .equal, toItem: nil, attribute: .notAnAttribute, multiplier: 1, constant: width) + backgroundView.addConstraint(constraint) + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/CALayer+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/CALayer+Extensions.swift new file mode 100644 index 0000000..e0b32f5 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/CALayer+Extensions.swift @@ -0,0 +1,18 @@ +// +// CALayer+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/3/18. +// Copyright © 2018 SwiftKick Mobile. All rights reserved. +// + +import QuartzCore + +extension CALayer { + func findAnimation(forKeyPath keyPath: String) -> CABasicAnimation? { + return animationKeys()? + .compactMap({ animation(forKey: $0) as? CABasicAnimation }) + .filter({ $0.keyPath == keyPath }) + .first + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/CornerRoundingView.swift b/Demo/Pods/SwiftMessages/SwiftMessages/CornerRoundingView.swift new file mode 100644 index 0000000..398b731 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/CornerRoundingView.swift @@ -0,0 +1,83 @@ +// +// CornerRoundingView.swift +// SwiftMessages +// +// Created by Timothy Moose on 7/28/18. +// Copyright © 2018 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +/// A background view that messages can use for rounding all or a subset of corners with squircles +/// (the smoother method of rounding corners that you see on app icons). +open class CornerRoundingView: UIView { + + /// Specifies the corner radius to use. + @IBInspectable + open var cornerRadius: CGFloat = 0 { + didSet { + updateMaskPath() + } + } + + /// Set to `true` for layouts where only the leading corners should be + /// rounded. For example, the layout in TabView.xib rounds the bottom corners + /// when displayed from the top and the top corners when displayed from the bottom. + /// When this property is `true`, the `roundedCorners` property will be overwritten + /// by relevant animators (e.g. `TopBottomAnimation`). + @IBInspectable + open var roundsLeadingCorners: Bool = false + + /// Specifies which corners should be rounded. When `roundsLeadingCorners = true`, relevant + /// relevant animators (e.g. `TopBottomAnimation`) will overwrite the value of this property. + open var roundedCorners: UIRectCorner = [.allCorners] { + didSet { + updateMaskPath() + } + } + + override public init(frame: CGRect) { + super.init(frame: frame) + sharedInit() + } + + required public init?(coder aDecoder: NSCoder) { + super.init(coder: aDecoder) + sharedInit() + } + + private func sharedInit() { + layer.mask = shapeLayer + } + + private let shapeLayer = CAShapeLayer() + + override open func layoutSubviews() { + super.layoutSubviews() + updateMaskPath() + } + + private func updateMaskPath() { + let newPath = UIBezierPath(roundedRect: layer.bounds, byRoundingCorners: roundedCorners, cornerRadii: cornerRadii).cgPath + // Update the `shapeLayer's` path with animation if we detect our `layer's` size is being animated. + // This is a workaround needed for smooth rotation animations. + if let foundAnimation = layer.findAnimation(forKeyPath: "bounds.size") { + // Update the `shapeLayer's` path with animation, copying the relevant properties + // from the found animation. + let animation = CABasicAnimation(keyPath: "path") + animation.duration = foundAnimation.duration + animation.timingFunction = foundAnimation.timingFunction + animation.fromValue = shapeLayer.path + animation.toValue = newPath + shapeLayer.add(animation, forKey: "path") + shapeLayer.path = newPath + } else { + // Update the `shapeLayer's` path without animation + shapeLayer.path = newPath + } + } + + private var cornerRadii: CGSize { + return CGSize(width: cornerRadius, height: cornerRadius) + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Error.swift b/Demo/Pods/SwiftMessages/SwiftMessages/Error.swift new file mode 100644 index 0000000..9a540ca --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Error.swift @@ -0,0 +1,17 @@ +// +// Error.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/7/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import Foundation + +/** + The `SwiftMessagesError` enum contains the errors thrown by SwiftMessages. + */ +enum SwiftMessagesError: Error { + case cannotLoadViewFromNib(nibName: String) + case noRootViewController +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Identifiable.swift b/Demo/Pods/SwiftMessages/SwiftMessages/Identifiable.swift new file mode 100644 index 0000000..4594b2d --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Identifiable.swift @@ -0,0 +1,22 @@ +// +// Identifiable.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/1/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import Foundation + +/** + Message views that adopt the `Identifiable` protocol will have duplicate messages + removed from the `MessageView` queue. Typically, the `id` would be set to a string + representation of the content of the message view. For example, `MessageView`, combines + the title and message body text. + + This protocol is optional. Message views that don't adopt `Identifiable` will not + have duplicates removed. + */ +public protocol Identifiable { + var id: String { get } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/KeyboardTrackingView.swift b/Demo/Pods/SwiftMessages/SwiftMessages/KeyboardTrackingView.swift new file mode 100644 index 0000000..301d969 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/KeyboardTrackingView.swift @@ -0,0 +1,143 @@ +// +// KeyboardTrackingView.swift +// SwiftMessages +// +// Created by Timothy Moose on 5/20/19. +// Copyright © 2019 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +public protocol KeyboardTrackingViewDelegate: AnyObject { + func keyboardTrackingViewWillChange(change: KeyboardTrackingView.Change, userInfo: [AnyHashable : Any]) + func keyboardTrackingViewDidChange(change: KeyboardTrackingView.Change, userInfo: [AnyHashable : Any]) +} + +/// A view that adjusts it's height based on keyboard hide and show notifications. +/// Pin it to the bottom of the screen using Auto Layout and then pin views that +/// should avoid the keyboard to the top of it. Supply an instance of this class +/// on `SwiftMessages.Config.keyboardTrackingView` or `SwiftMessagesSegue.keyboardTrackingView` +/// for automatic keyboard avoidance for the entire SwiftMessages view or view controller. +open class KeyboardTrackingView: UIView { + + public enum Change { + case show + case hide + case frame + } + + public weak var delegate: KeyboardTrackingViewDelegate? + + /// Typically, when a view controller is not being displayed, keyboard + /// tracking should be paused to avoid responding to keyboard events + /// caused by other view controllers or apps. Setting `isPaused = false` in + /// `viewWillAppear` and `isPaused = true` in `viewWillDisappear` usually works. This class + /// automatically pauses and resumes when the app resigns and becomes active, respectively. + open var isPaused = false { + didSet { + if !isPaused { + isAutomaticallyPaused = false + } + } + } + + /// The margin to maintain between the keyboard and the top of the view. + @IBInspectable open var topMargin: CGFloat = 0 + + /// Subclasses can override this to do something before the change. + open func willChange( + change: KeyboardTrackingView.Change, + userInfo: [AnyHashable : Any] + ) {} + + /// Subclasses can override this to do something after the change. + open func didChange( + change: KeyboardTrackingView.Change, + userInfo: [AnyHashable : Any] + ) {} + + override public init(frame: CGRect) { + super.init(frame: frame) + postInit() + } + + required public init?(coder aDecoder: NSCoder) { + super.init(coder: aDecoder) + } + + open override func awakeFromNib() { + super.awakeFromNib() + postInit() + } + + private var isAutomaticallyPaused = false + private var heightConstraint: NSLayoutConstraint! + + private func postInit() { + translatesAutoresizingMaskIntoConstraints = false + heightConstraint = heightAnchor.constraint(equalToConstant: 0) + heightConstraint.isActive = true + NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillShow(_:)), name: UIResponder.keyboardWillShowNotification, object: nil) + NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillShow(_:)), name: UIResponder.keyboardWillChangeFrameNotification, object: nil) + NotificationCenter.default.addObserver(self, selector: #selector(keyboardWillHide(_:)), name: UIResponder.keyboardWillHideNotification, object: nil) + NotificationCenter.default.addObserver(self, selector: #selector(pause), name: UIApplication.willResignActiveNotification, object: nil) + NotificationCenter.default.addObserver(self, selector: #selector(resume), name: UIApplication.didBecomeActiveNotification, object: nil) + backgroundColor = .clear + } + + @objc private func keyboardWillChangeFrame(_ notification: Notification) { + show(change: .frame, notification) + } + + @objc private func keyboardWillShow(_ notification: Notification) { + show(change: .show, notification) + } + + @objc private func keyboardWillHide(_ notification: Notification) { + guard !(isPaused || isAutomaticallyPaused), + let userInfo = (notification as NSNotification).userInfo else { return } + guard heightConstraint.constant != 0 else { return } + delegate?.keyboardTrackingViewWillChange(change: .hide, userInfo: userInfo) + animateKeyboardChange(change: .hide, height: 0, userInfo: userInfo) + } + + @objc private func pause() { + isAutomaticallyPaused = true + } + + @objc private func resume() { + isAutomaticallyPaused = false + } + + private func show(change: Change, _ notification: Notification) { + guard !(isPaused || isAutomaticallyPaused), + let userInfo = (notification as NSNotification).userInfo, + let value = userInfo[UIResponder.keyboardFrameEndUserInfoKey] as? NSValue else { return } + willChange(change: change, userInfo: userInfo) + delegate?.keyboardTrackingViewWillChange(change: change, userInfo: userInfo) + let keyboardRect = value.cgRectValue + let thisRect = convert(bounds, to: nil) + let newHeight = max(0, thisRect.maxY - keyboardRect.minY) + topMargin + guard heightConstraint.constant != newHeight else { return } + animateKeyboardChange(change: change, height: newHeight, userInfo: userInfo) + } + + private func animateKeyboardChange(change: Change, height: CGFloat, userInfo: [AnyHashable: Any]) { + self.heightConstraint.constant = height + if let durationNumber = userInfo[UIResponder.keyboardAnimationDurationUserInfoKey] as? NSNumber, + let curveNumber = userInfo[UIResponder.keyboardAnimationCurveUserInfoKey] as? NSNumber { + CATransaction.begin() + CATransaction.setCompletionBlock { + self.didChange(change: change, userInfo: userInfo) + self.delegate?.keyboardTrackingViewDidChange(change: change, userInfo: userInfo) + } + UIView.beginAnimations(nil, context: nil) + UIView.setAnimationDuration(durationNumber.doubleValue) + UIView.setAnimationCurve(UIView.AnimationCurve(rawValue: curveNumber.intValue)!) + UIView.setAnimationBeginsFromCurrentState(true) + self.superview?.layoutIfNeeded() + UIView.commitAnimations() + CATransaction.commit() + } + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/MarginAdjustable+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/MarginAdjustable+Extensions.swift new file mode 100644 index 0000000..b627788 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/MarginAdjustable+Extensions.swift @@ -0,0 +1,60 @@ +// +// MarginAdjustable+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 11/5/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +extension MarginAdjustable where Self: UIView { + public func defaultMarginAdjustment(context: AnimationContext) -> UIEdgeInsets { + var layoutMargins: UIEdgeInsets = layoutMarginAdditions + var safeAreaInsets: UIEdgeInsets = { + guard respectSafeArea else { return .zero } + if #available(iOS 11, *) { + insetsLayoutMarginsFromSafeArea = false + return self.safeAreaInsets + } else { + #if SWIFTMESSAGES_APP_EXTENSIONS + let application: UIApplication? = nil + #else + let application: UIApplication? = UIApplication.shared + #endif + if !context.safeZoneConflicts.isDisjoint(with: [.statusBar]), + let app = application, + app.statusBarOrientation == .portrait || app.statusBarOrientation == .portraitUpsideDown { + let frameInWindow = convert(bounds, to: window) + let top = max(0, 20 - frameInWindow.minY) + return UIEdgeInsets(top: top, left: 0, bottom: 0, right: 0) + } else { + return .zero + } + } + }() + if !context.safeZoneConflicts.isDisjoint(with: .overStatusBar) { + safeAreaInsets.top = 0 + } + layoutMargins = collapseLayoutMarginAdditions + ? layoutMargins.collapse(toInsets: safeAreaInsets) + : layoutMargins + safeAreaInsets + return layoutMargins + } +} + +extension UIEdgeInsets { + func collapse(toInsets insets: UIEdgeInsets) -> UIEdgeInsets { + let top = self.top.collapse(toInset: insets.top) + let left = self.left.collapse(toInset: insets.left) + let bottom = self.bottom.collapse(toInset: insets.bottom) + let right = self.right.collapse(toInset: insets.right) + return UIEdgeInsets(top: top, left: left, bottom: bottom, right: right) + } +} + +extension CGFloat { + func collapse(toInset inset: CGFloat) -> CGFloat { + return Swift.max(self, inset) + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/MarginAdjustable.swift b/Demo/Pods/SwiftMessages/SwiftMessages/MarginAdjustable.swift new file mode 100644 index 0000000..86fe901 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/MarginAdjustable.swift @@ -0,0 +1,42 @@ +// +// MarginAdjustable.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/5/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +/* + Message views that implement the `MarginAdjustable` protocol will have their + `layoutMargins` adjusted by SwiftMessages to account for the height of the + status bar (when displayed under the status bar) and a small amount of + overshoot in the bounce animation. `MessageView` implements this protocol + by way of its parent class `BaseView`. + + For the effect of this protocol to work, subviews should be pinned to the + message view's margins and the `layoutMargins` property should not be modified. + + This protocol is optional. A message view that doesn't implement `MarginAdjustable` + is responsible for setting is own internal margins appropriately. + */ +public protocol MarginAdjustable { + + /// The amount to add to the safe area insets in calculating + /// the layout margins. + var layoutMarginAdditions: UIEdgeInsets { get } + + /// When `true`, SwiftMessages automatically collapses layout margin additions (topLayoutMarginAddition, etc.) + /// when the default layout margins are greater than zero. This is typically used when a margin addition is only + /// needed when the safe area inset is zero for a given edge. When the safe area inset for a given edge is non-zero, + /// the additional margin is not added. + var collapseLayoutMarginAdditions: Bool { get set } + + + /// Start margins from the safe area. + var respectSafeArea: Bool { get set } + + var bounceAnimationOffset: CGFloat { get set } +} + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/MaskingView.swift b/Demo/Pods/SwiftMessages/SwiftMessages/MaskingView.swift new file mode 100644 index 0000000..d631342 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/MaskingView.swift @@ -0,0 +1,79 @@ +// +// MaskingView.swift +// SwiftMessages +// +// Created by Timothy Moose on 3/11/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import UIKit + + +class MaskingView: PassthroughView { + + func install(keyboardTrackingView: KeyboardTrackingView) { + self.keyboardTrackingView = keyboardTrackingView + keyboardTrackingView.translatesAutoresizingMaskIntoConstraints = false + addSubview(keyboardTrackingView) + keyboardTrackingView.bottomAnchor.constraint(equalTo: bottomAnchor).isActive = true + keyboardTrackingView.leadingAnchor.constraint(equalTo: leadingAnchor).isActive = true + keyboardTrackingView.trailingAnchor.constraint(equalTo: trailingAnchor).isActive = true + } + + var accessibleElements: [NSObject] = [] + + weak var backgroundView: UIView? { + didSet { + oldValue?.removeFromSuperview() + if let view = backgroundView { + view.isUserInteractionEnabled = false + view.frame = bounds + view.autoresizingMask = [.flexibleWidth, .flexibleHeight] + addSubview(view) + sendSubviewToBack(view) + } + } + } + + override func accessibilityElementCount() -> Int { + return accessibleElements.count + } + + override func accessibilityElement(at index: Int) -> Any? { + return accessibleElements[index] + } + + override func index(ofAccessibilityElement element: Any) -> Int { + guard let object = element as? NSObject else { return 0 } + return accessibleElements.firstIndex(of: object) ?? 0 + } + + init() { + super.init(frame: CGRect.zero) + clipsToBounds = true + } + + required init?(coder aDecoder: NSCoder) { + super.init(coder: aDecoder) + clipsToBounds = true + } + + private var keyboardTrackingView: KeyboardTrackingView? + + override func addSubview(_ view: UIView) { + super.addSubview(view) + guard let keyboardTrackingView = keyboardTrackingView, + view != keyboardTrackingView, + view != backgroundView else { return } + let offset: CGFloat + if let adjustable = view as? MarginAdjustable { + offset = -adjustable.bounceAnimationOffset + } else { + offset = 0 + } + keyboardTrackingView.topAnchor.constraint( + greaterThanOrEqualTo: view.bottomAnchor, + constant: offset + ).with(priority: UILayoutPriority(250)).isActive = true + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/MessageView.swift b/Demo/Pods/SwiftMessages/SwiftMessages/MessageView.swift new file mode 100644 index 0000000..c71141a --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/MessageView.swift @@ -0,0 +1,440 @@ +// +// MessageView.swift +// SwiftMessages +// +// Created by Timothy Moose on 7/30/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +/* + */ +open class MessageView: BaseView, Identifiable, AccessibleMessage { + + /* + MARK: - Button tap handler + */ + + /// An optional button tap handler. The `button` is automatically + /// configured to call this tap handler on `.TouchUpInside`. + open var buttonTapHandler: ((_ button: UIButton) -> Void)? + + @objc func buttonTapped(_ button: UIButton) { + buttonTapHandler?(button) + } + + /* + MARK: - Touch handling + */ + + open override func point(inside point: CGPoint, with event: UIEvent?) -> Bool { + // Only accept touches within the background view. Anything outside of the + // background view's bounds should be transparent and does not need to receive + // touches. This helps with tap dismissal when using `DimMode.gray` and `DimMode.color`. + return backgroundView == self + ? super.point(inside: point, with: event) + : backgroundView.point(inside: convert(point, to: backgroundView), with: event) + } + + /* + MARK: - IB outlets + */ + + /// An optional title label. + @IBOutlet open var titleLabel: UILabel? + + /// An optional body text label. + @IBOutlet open var bodyLabel: UILabel? + + /// An optional icon image view. + @IBOutlet open var iconImageView: UIImageView? + + /// An optional icon label (e.g. for emoji character, icon font, etc.). + @IBOutlet open var iconLabel: UILabel? + + /// An optional button. This buttons' `.TouchUpInside` event will automatically + /// invoke the optional `buttonTapHandler`, but its fine to add other target + /// action handlers can be added. + @IBOutlet open var button: UIButton? { + didSet { + if let old = oldValue { + old.removeTarget(self, action: #selector(MessageView.buttonTapped(_:)), for: .touchUpInside) + } + if let button = button { + button.addTarget(self, action: #selector(MessageView.buttonTapped(_:)), for: .touchUpInside) + } + } + } + + /* + MARK: - Identifiable + */ + + open var id: String { + get { + return customId ?? "MessageView:title=\(String(describing: titleLabel?.text)), body=\(String(describing: bodyLabel?.text))" + } + set { + customId = newValue + } + } + + private var customId: String? + + /* + MARK: - AccessibleMessage + */ + + /** + An optional prefix for the `accessibilityMessage` that can + be used to further clarify the message for VoiceOver. For example, + the view's background color or icon might convey that a message is + a warning, in which case one may specify the value "warning". + */ + open var accessibilityPrefix: String? + + open var accessibilityMessage: String? { + #if swift(>=4.1) + let components = [accessibilityPrefix, titleLabel?.text, bodyLabel?.text].compactMap { $0 } + #else + let components = [accessibilityPrefix, titleLabel?.text, bodyLabel?.text].flatMap { $0 } + #endif + guard components.count > 0 else { return nil } + return components.joined(separator: ", ") + } + + public var accessibilityElement: NSObject? { + return backgroundView + } + + open var additionalAccessibilityElements: [NSObject]? { + var elements: [NSObject] = [] + func getAccessibleSubviews(view: UIView) { + for subview in view.subviews { + if subview.isAccessibilityElement { + elements.append(subview) + } else { + // Only doing this for non-accessible `subviews`, which avoids + // including button labels, etc. + getAccessibleSubviews(view: subview) + } + } + } + getAccessibleSubviews(view: self.backgroundView) + return elements + } +} + +/* + MARK: - Creating message views + + This extension provides several convenience functions for instantiating + `MessageView` from the included nib files in a type-safe way. These nib + files can be found in the Resources folder and can be drag-and-dropped + into a project and modified. You may still use these APIs if you've + copied the nib files because SwiftMessages looks for them in the main + bundle first. See `SwiftMessages` for additional nib loading options. + */ + +extension MessageView { + + /** + Specifies one of the nib files included in the Resources folders. + */ + public enum Layout: String { + + /** + The standard message view that stretches across the full width of the + container view. + */ + case messageView = "MessageView" + + /** + A floating card-style view with rounded corners. + */ + case cardView = "CardView" + + /** + Like `CardView` with one end attached to the super view. + */ + case tabView = "TabView" + + /** + A 20pt tall view that can be used to overlay the status bar. + Note that this layout will automatically grow taller if displayed + directly under the status bar (see the `ContentInsetting` protocol). + */ + case statusLine = "StatusLine" + + /** + A floating card-style view with elements centered and arranged vertically. + This view is typically used with `.center` presentation style. + */ + case centeredView = "CenteredView" + } + + /** + Loads the nib file associated with the given `Layout` and returns the first + view found in the nib file with the matching type `T: MessageView`. + + - Parameter layout: The `Layout` option to use. + - Parameter filesOwner: An optional files owner. + + - Returns: An instance of generic view type `T: MessageView`. + */ + public static func viewFromNib(layout: Layout, filesOwner: AnyObject = NSNull.init()) -> T { + return try! SwiftMessages.viewFromNib(named: layout.rawValue) + } + + /** + Loads the nib file associated with the given `Layout` from + the given bundle and returns the first view found in the nib + file with the matching type `T: MessageView`. + + - Parameter layout: The `Layout` option to use. + - Parameter bundle: The name of the bundle containing the nib file. + - Parameter filesOwner: An optional files owner. + + - Returns: An instance of generic view type `T: MessageView`. + */ + public static func viewFromNib(layout: Layout, bundle: Bundle, filesOwner: AnyObject = NSNull.init()) -> T { + return try! SwiftMessages.viewFromNib(named: layout.rawValue, bundle: bundle, filesOwner: filesOwner) + } +} + +/* + MARK: - Layout adjustments + + This extension provides a few convenience functions for adjusting the layout. + */ + +extension MessageView { + /** + Constrains the image view to a specified size. By default, the size of the + image view is determined by its `intrinsicContentSize`. + + - Parameter size: The size to be translated into Auto Layout constraints. + - Parameter contentMode: The optional content mode to apply. + */ + public func configureIcon(withSize size: CGSize, contentMode: UIView.ContentMode? = nil) { + var views: [UIView] = [] + if let iconImageView = iconImageView { views.append(iconImageView) } + if let iconLabel = iconLabel { views.append(iconLabel) } + views.forEach { + let constraints = [$0.heightAnchor.constraint(equalToConstant: size.height), + $0.widthAnchor.constraint(equalToConstant: size.width)] + constraints.forEach { $0.priority = UILayoutPriority(999.0) } + $0.addConstraints(constraints) + if let contentMode = contentMode { + $0.contentMode = contentMode + } + } + } +} + +/* + MARK: - Theming + + This extension provides a few convenience functions for setting styles, + colors and icons. You are encouraged to write your own such functions + if these don't exactly meet your needs. + */ + +extension MessageView { + + /** + A convenience function for setting some pre-defined colors and icons. + + - Parameter theme: The theme type to use. + - Parameter iconStyle: The icon style to use. Defaults to `.Default`. + */ + public func configureTheme(_ theme: Theme, iconStyle: IconStyle = .default) { + let iconImage = iconStyle.image(theme: theme) + let backgroundColor: UIColor + let foregroundColor: UIColor + let defaultBackgroundColor: UIColor + let defaultForegroundColor: UIColor + switch theme { + case .info: + defaultBackgroundColor = UIColor(red: 225.0/255.0, green: 225.0/255.0, blue: 225.0/255.0, alpha: 1.0) + defaultForegroundColor = UIColor.darkText + case .success: + defaultBackgroundColor = UIColor(red: 97.0/255.0, green: 161.0/255.0, blue: 23.0/255.0, alpha: 1.0) + defaultForegroundColor = UIColor.white + case .warning: + defaultBackgroundColor = UIColor(red: 246.0/255.0, green: 197.0/255.0, blue: 44.0/255.0, alpha: 1.0) + defaultForegroundColor = UIColor.white + case .error: + defaultBackgroundColor = UIColor(red: 249.0/255.0, green: 66.0/255.0, blue: 47.0/255.0, alpha: 1.0) + defaultForegroundColor = UIColor.white + } + if #available(iOS 13.0, *) { + switch theme { + case .info: + backgroundColor = UIColor { + switch $0.userInterfaceStyle { + case .dark, .unspecified: return UIColor(red: 125/255.0, green: 125/255.0, blue: 125/255.0, alpha: 1.0) + case .light: fallthrough + @unknown default: + return defaultBackgroundColor + } + } + foregroundColor = .label + case .success: + backgroundColor = UIColor { + switch $0.userInterfaceStyle { + case .dark, .unspecified: return UIColor(red: 55/255.0, green: 122/255.0, blue: 0/255.0, alpha: 1.0) + case .light: fallthrough + @unknown default: + return defaultBackgroundColor + } + } + foregroundColor = .white + case .warning: + backgroundColor = UIColor { + switch $0.userInterfaceStyle { + case .dark, .unspecified: return UIColor(red: 239/255.0, green: 184/255.0, blue: 10/255.0, alpha: 1.0) + case .light: fallthrough + @unknown default: + return defaultBackgroundColor + } + } + foregroundColor = .white + case .error: + backgroundColor = UIColor { + switch $0.userInterfaceStyle { + case .dark, .unspecified: return UIColor(red: 195/255.0, green: 12/255.0, blue: 12/255.0, alpha: 1.0) + case .light: fallthrough + @unknown default: + return defaultBackgroundColor + } + } + foregroundColor = .white + } + } else { + backgroundColor = defaultBackgroundColor + foregroundColor = defaultForegroundColor + } + configureTheme(backgroundColor: backgroundColor, foregroundColor: foregroundColor, iconImage: iconImage) + } + + /** + A convenience function for setting a foreground and background color. + Note that images will only display the foreground color if they're + configured with UIImageRenderingMode.AlwaysTemplate. + + - Parameter backgroundColor: The background color to use. + - Parameter foregroundColor: The foreground color to use. + */ + public func configureTheme(backgroundColor: UIColor, foregroundColor: UIColor, iconImage: UIImage? = nil, iconText: String? = nil) { + iconImageView?.image = iconImage + iconLabel?.text = iconText + iconImageView?.tintColor = foregroundColor + let backgroundView = self.backgroundView ?? self + backgroundView.backgroundColor = backgroundColor + iconLabel?.textColor = foregroundColor + titleLabel?.textColor = foregroundColor + bodyLabel?.textColor = foregroundColor + button?.backgroundColor = foregroundColor + button?.tintColor = backgroundColor + button?.contentEdgeInsets = UIEdgeInsets(top: 7.0, left: 7.0, bottom: 7.0, right: 7.0) + button?.layer.cornerRadius = 5.0 + iconImageView?.isHidden = iconImageView?.image == nil + iconLabel?.isHidden = iconLabel?.text == nil + } +} + +/* + MARK: - Configuring the content + + This extension provides a few convenience functions for configuring the + message content. You are encouraged to write your own such functions + if these don't exactly meet your needs. + + SwiftMessages does not try to be clever by adjusting the layout based on + what content you configure. All message elements are optional and it is + up to you to hide or remove elements you don't need. The easiest way to + remove unwanted elements is to drag-and-drop one of the included nib + files into your project as a starting point and make changes. + */ + +extension MessageView { + + /** + Sets the message body text. + + - Parameter body: The message body text to use. + */ + public func configureContent(body: String) { + bodyLabel?.text = body + } + + /** + Sets the message title and body text. + + - Parameter title: The message title to use. + - Parameter body: The message body text to use. + */ + public func configureContent(title: String, body: String) { + configureContent(body: body) + titleLabel?.text = title + } + + /** + Sets the message title, body text and icon image. Also hides the + `iconLabel`. + + - Parameter title: The message title to use. + - Parameter body: The message body text to use. + - Parameter iconImage: The icon image to use. + */ + public func configureContent(title: String, body: String, iconImage: UIImage) { + configureContent(title: title, body: body) + iconImageView?.image = iconImage + iconImageView?.isHidden = false + iconLabel?.text = nil + iconLabel?.isHidden = true + } + + /** + Sets the message title, body text and icon text (e.g. an emoji). + Also hides the `iconImageView`. + + - Parameter title: The message title to use. + - Parameter body: The message body text to use. + - Parameter iconText: The icon text to use (e.g. an emoji). + */ + public func configureContent(title: String, body: String, iconText: String) { + configureContent(title: title, body: body) + iconLabel?.text = iconText + iconLabel?.isHidden = false + iconImageView?.isHidden = true + iconImageView?.image = nil + } + + /** + Sets all configurable elements. + + - Parameter title: The message title to use. + - Parameter body: The message body text to use. + - Parameter iconImage: The icon image to use. + - Parameter iconText: The icon text to use (e.g. an emoji). + - Parameter buttonImage: The button image to use. + - Parameter buttonTitle: The button title to use. + - Parameter buttonTapHandler: The button tap handler block to use. + */ + public func configureContent(title: String?, body: String?, iconImage: UIImage?, iconText: String?, buttonImage: UIImage?, buttonTitle: String?, buttonTapHandler: ((_ button: UIButton) -> Void)?) { + titleLabel?.text = title + bodyLabel?.text = body + iconImageView?.image = iconImage + iconLabel?.text = iconText + button?.setImage(buttonImage, for: .normal) + button?.setTitle(buttonTitle, for: .normal) + self.buttonTapHandler = buttonTapHandler + iconImageView?.isHidden = iconImageView?.image == nil + iconLabel?.isHidden = iconLabel?.text == nil + } +} + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/NSBundle+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/NSBundle+Extensions.swift new file mode 100644 index 0000000..fdfb08b --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/NSBundle+Extensions.swift @@ -0,0 +1,48 @@ +// +// NSBundle+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/8/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import Foundation + +private class BundleToken {} + +extension Bundle { + // This is copied method from SPM generated Bundle.module for CocoaPods support + static func sm_frameworkBundle() -> Bundle { + + let candidates = [ + // Bundle should be present here when the package is linked into an App. + Bundle.main.resourceURL, + + // Bundle should be present here when the package is linked into a framework. + Bundle(for: BundleToken.self).resourceURL, + + // For command-line tools. + Bundle.main.bundleURL, + ] + + let bundleNames = [ + // For Swift Package Manager + "SwiftMessages_SwiftMessages", + + // For Carthage + "SwiftMessages", + ] + + for bundleName in bundleNames { + for candidate in candidates { + let bundlePath = candidate?.appendingPathComponent(bundleName + ".bundle") + if let bundle = bundlePath.flatMap(Bundle.init(url:)) { + return bundle + } + } + } + + // Return whatever bundle this code is in as a last resort. + return Bundle(for: BundleToken.self) + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/NSLayoutConstraint+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/NSLayoutConstraint+Extensions.swift new file mode 100644 index 0000000..01f678d --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/NSLayoutConstraint+Extensions.swift @@ -0,0 +1,16 @@ +// +// NSLayoutConstraint+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 5/18/19. +// Copyright © 2019 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +extension NSLayoutConstraint { + func with(priority: UILayoutPriority) -> NSLayoutConstraint { + self.priority = priority + return self + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/PassthroughView.swift b/Demo/Pods/SwiftMessages/SwiftMessages/PassthroughView.swift new file mode 100644 index 0000000..d76da24 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/PassthroughView.swift @@ -0,0 +1,37 @@ +// +// PassthroughView.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/5/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +class PassthroughView: UIControl { + + var tappedHander: (() -> Void)? + + override init(frame: CGRect) { + super.init(frame: frame) + initCommon() + } + + required init?(coder aDecoder: NSCoder) { + super.init(coder: aDecoder) + initCommon() + } + + private func initCommon() { + addTarget(self, action: #selector(tapped), for: .touchUpInside) + } + + @objc func tapped() { + tappedHander?() + } + + override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? { + let view = super.hitTest(point, with: event) + return view == self && tappedHander == nil ? nil : view + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/PassthroughWindow.swift b/Demo/Pods/SwiftMessages/SwiftMessages/PassthroughWindow.swift new file mode 100644 index 0000000..704e481 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/PassthroughWindow.swift @@ -0,0 +1,36 @@ +// +// PassthroughWindow.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/5/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +class PassthroughWindow: UIWindow { + + override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? { + // iOS has started embedding the SwiftMessages view in private views that block + // interaction with views underneath, essentially making the window behave like a modal. + // To work around this, we'll ignore hit test results on these views. + let view = super.hitTest(point, with: event) + if let view = view, + let hitTestView = hitTestView, + hitTestView.isDescendant(of: view) && hitTestView != view { + return nil + } + return view + } + + init(hitTestView: UIView) { + self.hitTestView = hitTestView + super.init(frame: .zero) + } + + required init?(coder: NSCoder) { + fatalError("init(coder:) has not been implemented") + } + + private weak var hitTestView: UIView? +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/PhysicsAnimation.swift b/Demo/Pods/SwiftMessages/SwiftMessages/PhysicsAnimation.swift new file mode 100644 index 0000000..0fb976c --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/PhysicsAnimation.swift @@ -0,0 +1,125 @@ +// +// PhysicsAnimation.swift +// SwiftMessages +// +// Created by Timothy Moose on 6/14/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +public class PhysicsAnimation: NSObject, Animator { + + public enum Placement { + case top + case center + case bottom + } + + open var placement: Placement = .center + + open var showDuration: TimeInterval = 0.5 + + open var hideDuration: TimeInterval = 0.15 + + public var panHandler = PhysicsPanHandler() + + public weak var delegate: AnimationDelegate? + weak var messageView: UIView? + weak var containerView: UIView? + var context: AnimationContext? + + public override init() {} + + init(delegate: AnimationDelegate) { + self.delegate = delegate + } + + public func show(context: AnimationContext, completion: @escaping AnimationCompletion) { + NotificationCenter.default.addObserver(self, selector: #selector(adjustMargins), name: UIDevice.orientationDidChangeNotification, object: nil) + install(context: context) + showAnimation(context: context, completion: completion) + } + + public func hide(context: AnimationContext, completion: @escaping AnimationCompletion) { + NotificationCenter.default.removeObserver(self) + if panHandler.isOffScreen { + context.messageView.alpha = 0 + panHandler.state?.stop() + } + let view = context.messageView + self.context = context + CATransaction.begin() + CATransaction.setCompletionBlock { + view.alpha = 1 + view.transform = CGAffineTransform.identity + completion(true) + } + UIView.animate(withDuration: hideDuration, delay: 0, options: [.beginFromCurrentState, .curveEaseIn, .allowUserInteraction], animations: { + view.transform = CGAffineTransform(scaleX: 0.8, y: 0.8) + }, completion: nil) + UIView.animate(withDuration: hideDuration, delay: 0, options: [.beginFromCurrentState, .curveEaseIn, .allowUserInteraction], animations: { + view.alpha = 0 + }, completion: nil) + CATransaction.commit() + } + + func install(context: AnimationContext) { + let view = context.messageView + let container = context.containerView + messageView = view + containerView = container + self.context = context + view.translatesAutoresizingMaskIntoConstraints = false + container.addSubview(view) + switch placement { + case .center: + view.centerYAnchor.constraint(equalTo: container.centerYAnchor).with(priority: UILayoutPriority(200)).isActive = true + case .top: + view.topAnchor.constraint(equalTo: container.topAnchor).with(priority: UILayoutPriority(200)).isActive = true + case .bottom: + view.bottomAnchor.constraint(equalTo: container.bottomAnchor).with(priority: UILayoutPriority(200)).isActive = true + } + NSLayoutConstraint(item: view, attribute: .leading, relatedBy: .equal, toItem: container, attribute: .leading, multiplier: 1, constant: 0).isActive = true + NSLayoutConstraint(item: view, attribute: .trailing, relatedBy: .equal, toItem: container, attribute: .trailing, multiplier: 1, constant: 0).isActive = true + // Important to layout now in order to get the right safe area insets + container.layoutIfNeeded() + adjustMargins() + container.layoutIfNeeded() + installInteractive(context: context) + } + + @objc public func adjustMargins() { + guard let adjustable = messageView as? MarginAdjustable & UIView, + let context = context else { return } + adjustable.preservesSuperviewLayoutMargins = false + if #available(iOS 11, *) { + adjustable.insetsLayoutMarginsFromSafeArea = false + } + adjustable.layoutMargins = adjustable.defaultMarginAdjustment(context: context) + } + + func showAnimation(context: AnimationContext, completion: @escaping AnimationCompletion) { + let view = context.messageView + view.alpha = 0.25 + view.transform = CGAffineTransform(scaleX: 0.6, y: 0.6) + CATransaction.begin() + CATransaction.setCompletionBlock { + completion(true) + } + UIView.animate(withDuration: showDuration, delay: 0, usingSpringWithDamping: 0.6, initialSpringVelocity: 0, options: [.beginFromCurrentState, .curveLinear, .allowUserInteraction], animations: { + view.transform = CGAffineTransform.identity + }, completion: nil) + UIView.animate(withDuration: 0.3 * showDuration, delay: 0, options: [.beginFromCurrentState, .curveLinear, .allowUserInteraction], animations: { + view.alpha = 1 + }, completion: nil) + CATransaction.commit() + } + + func installInteractive(context: AnimationContext) { + guard context.interactiveHide else { return } + panHandler.configure(context: context, animator: self) + } +} + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/PhysicsPanHandler.swift b/Demo/Pods/SwiftMessages/SwiftMessages/PhysicsPanHandler.swift new file mode 100644 index 0000000..da82fc1 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/PhysicsPanHandler.swift @@ -0,0 +1,175 @@ +// +// PhysicsPanHandler.swift +// SwiftMessages +// +// Created by Timothy Moose on 6/25/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +open class PhysicsPanHandler { + + public var hideDelay: TimeInterval = 0.2 + + public struct MotionSnapshot { + var angle: CGFloat + var time: CFAbsoluteTime + } + + public final class State { + + weak var messageView: UIView? + weak var containerView: UIView? + var dynamicAnimator: UIDynamicAnimator + var itemBehavior: UIDynamicItemBehavior + var attachmentBehavior: UIAttachmentBehavior? { + didSet { + if let oldValue = oldValue { + dynamicAnimator.removeBehavior(oldValue) + } + if let attachmentBehavior = attachmentBehavior { + dynamicAnimator.addBehavior(attachmentBehavior) + addSnapshot() + } + } + } + var snapshots: [MotionSnapshot] = [] + + public init(messageView: UIView, containerView: UIView) { + self.messageView = messageView + self.containerView = containerView + let dynamicAnimator = UIDynamicAnimator(referenceView: containerView) + let itemBehavior = UIDynamicItemBehavior(items: [messageView]) + itemBehavior.allowsRotation = true + dynamicAnimator.addBehavior(itemBehavior) + self.itemBehavior = itemBehavior + self.dynamicAnimator = dynamicAnimator + } + + func update(attachmentAnchorPoint anchorPoint: CGPoint) { + addSnapshot() + attachmentBehavior?.anchorPoint = anchorPoint + } + + func addSnapshot() { + let angle = messageView?.angle ?? snapshots.last?.angle ?? 0 + let time = CFAbsoluteTimeGetCurrent() + snapshots.append(MotionSnapshot(angle: angle, time: time)) + } + + public func stop() { + guard let messageView = messageView else { + dynamicAnimator.removeAllBehaviors() + return + } + let center = messageView.center + let transform = messageView.transform + dynamicAnimator.removeAllBehaviors() + messageView.center = center + messageView.transform = transform + } + + public var angularVelocity: CGFloat { + guard let last = snapshots.last else { return 0 } + for previous in snapshots.reversed() { + // Ignore snapshots where the angle or time hasn't changed to avoid degenerate cases. + if previous.angle != last.angle && previous.time != last.time { + return (last.angle - previous.angle) / CGFloat(last.time - previous.time) + } + } + return 0 + } + } + + weak var animator: Animator? + weak var messageView: UIView? + weak var containerView: UIView? + private(set) public var state: State? + private(set) public var isOffScreen = false + private var restingCenter: CGPoint? + + public init() {} + + public private(set) lazy var pan: UIPanGestureRecognizer = { + let pan = UIPanGestureRecognizer() + pan.addTarget(self, action: #selector(pan(_:))) + return pan + }() + + func configure(context: AnimationContext, animator: Animator) { + if let oldView = (messageView as? BackgroundViewable)?.backgroundView ?? messageView { + oldView.removeGestureRecognizer(pan) + } + messageView = context.messageView + let view = (messageView as? BackgroundViewable)?.backgroundView ?? messageView + view?.addGestureRecognizer(pan) + containerView = context.containerView + self.animator = animator + } + + @objc func pan(_ pan: UIPanGestureRecognizer) { + guard let messageView = messageView, let containerView = containerView, let animator = animator else { return } + let anchorPoint = pan.location(in: containerView) + switch pan.state { + case .began: + animator.delegate?.panStarted(animator: animator) + let state = State(messageView: messageView, containerView: containerView) + self.state = state + let center = messageView.center + restingCenter = center + let offset = UIOffset(horizontal: anchorPoint.x - center.x, vertical: anchorPoint.y - center.y) + let attachmentBehavior = UIAttachmentBehavior(item: messageView, offsetFromCenter: offset, attachedToAnchor: anchorPoint) + state.attachmentBehavior = attachmentBehavior + state.itemBehavior.action = { [weak self, weak messageView, weak containerView] in + guard let self = self, !self.isOffScreen, let messageView = messageView, let containerView = containerView, let animator = self.animator else { return } + let view = (messageView as? BackgroundViewable)?.backgroundView ?? messageView + let frame = containerView.convert(view.bounds, from: view) + if !containerView.bounds.intersects(frame) { + self.isOffScreen = true + DispatchQueue.main.asyncAfter(deadline: .now() + self.hideDelay) { + animator.delegate?.hide(animator: animator) + } + } + } + case .changed: + guard let state = state else { return } + state.update(attachmentAnchorPoint: anchorPoint) + case .ended, .cancelled: + guard let state = state else { return } + state.update(attachmentAnchorPoint: anchorPoint) + let velocity = pan.velocity(in: containerView) + let angularVelocity = state.angularVelocity + let speed = sqrt(pow(velocity.x, 2) + pow(velocity.y, 2)) + // The multiplier on angular velocity was determined by hand-tuning + let energy = sqrt(pow(speed, 2) + pow(angularVelocity * 75, 2)) + if energy > 200 && speed > 600 { + // Limit the speed and angular velocity to reasonable values + let speedScale = speed > 0 ? min(1, 1800 / speed) : 1 + let escapeVelocity = CGPoint(x: velocity.x * speedScale, y: velocity.y * speedScale) + let angularSpeedScale = min(1, 10 / abs(angularVelocity)) + let escapeAngularVelocity = angularVelocity * angularSpeedScale + state.itemBehavior.addLinearVelocity(escapeVelocity, for: messageView) + state.itemBehavior.addAngularVelocity(escapeAngularVelocity, for: messageView) + state.attachmentBehavior = nil + } else { + state.stop() + self.state = nil + animator.delegate?.panEnded(animator: animator) + UIView.animate(withDuration: 0.5, delay: 0, usingSpringWithDamping: 0.65, initialSpringVelocity: 0, options: .beginFromCurrentState, animations: { + messageView.center = self.restingCenter ?? CGPoint(x: containerView.bounds.width / 2, y: containerView.bounds.height / 2) + messageView.transform = CGAffineTransform.identity + }, completion: nil) + } + default: + break + } + } +} + +extension UIView { + var angle: CGFloat { + // http://stackoverflow.com/a/2051861/1271826 + return atan2(transform.b, transform.a) + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Presenter.swift b/Demo/Pods/SwiftMessages/SwiftMessages/Presenter.swift new file mode 100644 index 0000000..be093be --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Presenter.swift @@ -0,0 +1,423 @@ +// +// MessagePresenter.swift +// SwiftMessages +// +// Created by Timothy Moose on 7/30/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +protocol PresenterDelegate: AnimationDelegate { + func hide(presenter: Presenter) +} + +class Presenter: NSObject { + + // MARK: - API + + init(config: SwiftMessages.Config, view: UIView, delegate: PresenterDelegate) { + self.config = config + self.view = view + self.delegate = delegate + self.animator = Presenter.animator(forPresentationStyle: config.presentationStyle, delegate: delegate) + if let identifiable = view as? Identifiable { + id = identifiable.id + } else { + var mutableView = view + id = withUnsafePointer(to: &mutableView) { "\($0)" } + } + + super.init() + } + + var id: String + var config: SwiftMessages.Config + let maskingView = MaskingView() + let animator: Animator + var isHiding = false + let view: UIView + + var delayShow: TimeInterval? { + if case .indefinite(let delay, _) = config.duration { return delay } + return nil + } + + var showDate: CFTimeInterval? + + /// Returns the required delay for hiding based on time shown + var delayHide: TimeInterval? { + if interactivelyHidden { return 0 } + if case .indefinite(_, let minimum) = config.duration, let showDate = showDate { + let timeIntervalShown = CACurrentMediaTime() - showDate + return max(0, minimum - timeIntervalShown) + } + return nil + } + + var pauseDuration: TimeInterval? { + let duration: TimeInterval? + switch self.config.duration { + case .automatic: + duration = 2 + case .seconds(let seconds): + duration = seconds + case .forever, .indefinite: + duration = nil + } + return duration + } + + // MARK: - Constants + + enum PresentationContext { + case viewController(_: Weak) + case view(_: Weak) + + func viewControllerValue() -> UIViewController? { + switch self { + case .viewController(let weak): + return weak.value + case .view: + return nil + } + } + + func viewValue() -> UIView? { + switch self { + case .viewController(let weak): + return weak.value?.view + case .view(let weak): + return weak.value + } + } + } + + // MARK: - Variables + + private weak var delegate: PresenterDelegate? + private var presentationContext = PresentationContext.viewController(Weak(value: nil)) + + private var interactivelyHidden = false; + + // MARK: - Showing and hiding + + private static func animator(forPresentationStyle style: SwiftMessages.PresentationStyle, delegate: AnimationDelegate) -> Animator { + switch style { + case .top: + return TopBottomAnimation(style: .top, delegate: delegate) + case .bottom: + return TopBottomAnimation(style: .bottom, delegate: delegate) + case .center: + return PhysicsAnimation(delegate: delegate) + case .custom(let animator): + animator.delegate = delegate + return animator + } + } + + func show(completion: @escaping AnimationCompletion) throws { + try presentationContext = getPresentationContext() + install() + self.config.eventListeners.forEach { $0(.willShow(self.view)) } + showAnimation() { completed in + completion(completed) + if completed { + if self.config.dimMode.modal { + self.showAccessibilityFocus() + } else { + self.showAccessibilityAnnouncement() + } + self.config.eventListeners.forEach { $0(.didShow(self.view)) } + } + } + } + + private func showAnimation(completion: @escaping AnimationCompletion) { + + func dim(_ color: UIColor) { + self.maskingView.backgroundColor = UIColor.clear + UIView.animate(withDuration: 0.2, animations: { + self.maskingView.backgroundColor = color + }) + } + + func blur(style: UIBlurEffect.Style, alpha: CGFloat) { + let blurView = UIVisualEffectView(effect: nil) + blurView.alpha = alpha + maskingView.backgroundView = blurView + UIView.animate(withDuration: 0.3) { + blurView.effect = UIBlurEffect(style: style) + } + } + + let context = animationContext() + animator.show(context: context) { (completed) in + completion(completed) + } + switch config.dimMode { + case .none: + break + case .gray: + dim(UIColor(white: 0, alpha: 0.3)) + case .color(let color, _): + dim(color) + case .blur(let style, let alpha, _): + blur(style: style, alpha: alpha) + } + } + + private func showAccessibilityAnnouncement() { + guard let accessibleMessage = view as? AccessibleMessage, + let message = accessibleMessage.accessibilityMessage else { return } + UIAccessibility.post(notification: UIAccessibility.Notification.announcement, argument: message) + } + + private func showAccessibilityFocus() { + guard let accessibleMessage = view as? AccessibleMessage, + let focus = accessibleMessage.accessibilityElement ?? accessibleMessage.additionalAccessibilityElements?.first else { return } + UIAccessibility.post(notification: UIAccessibility.Notification.layoutChanged, argument: focus) + } + + func hide(animated: Bool, completion: @escaping AnimationCompletion) { + isHiding = true + self.config.eventListeners.forEach { $0(.willHide(self.view)) } + let context = animationContext() + let action = { + if let viewController = self.presentationContext.viewControllerValue() as? WindowViewController { + viewController.uninstall() + } + self.maskingView.removeFromSuperview() + completion(true) + self.config.eventListeners.forEach { $0(.didHide(self.view)) } + } + guard animated else { + action() + return + } + animator.hide(context: context) { (completed) in + action() + } + + func undim() { + UIView.animate(withDuration: 0.2, delay: 0, options: .beginFromCurrentState, animations: { + self.maskingView.backgroundColor = UIColor.clear + }, completion: nil) + } + + func unblur() { + guard let view = maskingView.backgroundView as? UIVisualEffectView else { return } + UIView.animate(withDuration: 0.2, delay: 0, options: .beginFromCurrentState, animations: { + view.effect = nil + }, completion: nil) + } + + switch config.dimMode { + case .none: + break + case .gray: + undim() + case .color: + undim() + case .blur: + unblur() + } + } + + private func animationContext() -> AnimationContext { + return AnimationContext(messageView: view, containerView: maskingView, safeZoneConflicts: safeZoneConflicts(), interactiveHide: config.interactiveHide) + } + + private func safeZoneConflicts() -> SafeZoneConflicts { + guard let window = maskingView.window else { return [] } + let windowLevel: UIWindow.Level = { + if let vc = presentationContext.viewControllerValue() as? WindowViewController { + return vc.config.windowLevel ?? .normal + } + return .normal + }() + // TODO `underNavigationBar` and `underTabBar` should look up the presentation context's hierarchy + // TODO for cases where both should be true (probably not an issue for typical height messages, though). + let underNavigationBar: Bool = { + if let vc = presentationContext.viewControllerValue() as? UINavigationController { return vc.sm_isVisible(view: vc.navigationBar) } + return false + }() + let underTabBar: Bool = { + if let vc = presentationContext.viewControllerValue() as? UITabBarController { return vc.sm_isVisible(view: vc.tabBar) } + return false + }() + if #available(iOS 11, *) { + if windowLevel > .normal { + // TODO seeing `maskingView.safeAreaInsets.top` value of 20 on + // iPhone 8 with status bar window level. This seems like an iOS bug since + // the message view's window is above the status bar. Applying a special rule + // to allow the animator to revove this amount from the layout margins if needed. + // This may need to be reworked if any future device has a legitimate 20pt top safe area, + // such as with a potentially smaller notch. + if maskingView.safeAreaInsets.top == 20 { + return [.overStatusBar] + } else { + var conflicts: SafeZoneConflicts = [] + if maskingView.safeAreaInsets.top > 0 { + conflicts.formUnion(.sensorNotch) + } + if maskingView.safeAreaInsets.bottom > 0 { + conflicts.formUnion(.homeIndicator) + } + return conflicts + } + } + var conflicts: SafeZoneConflicts = [] + if !underNavigationBar { + conflicts.formUnion(.sensorNotch) + } + if !underTabBar { + conflicts.formUnion(.homeIndicator) + } + return conflicts + } else { + #if SWIFTMESSAGES_APP_EXTENSIONS + return [] + #else + if UIApplication.shared.isStatusBarHidden { return [] } + if (windowLevel > UIWindow.Level.normal) || underNavigationBar { return [] } + let statusBarFrame = UIApplication.shared.statusBarFrame + let statusBarWindowFrame = window.convert(statusBarFrame, from: nil) + let statusBarViewFrame = maskingView.convert(statusBarWindowFrame, from: nil) + return statusBarViewFrame.intersects(maskingView.bounds) ? SafeZoneConflicts.statusBar : [] + #endif + } + } + + private func getPresentationContext() throws -> PresentationContext { + + func newWindowViewController() -> UIViewController { + let viewController = WindowViewController.newInstance(config: config) + return viewController + } + + switch config.presentationContext { + case .automatic: + #if SWIFTMESSAGES_APP_EXTENSIONS + throw SwiftMessagesError.noRootViewController + #else + if let rootViewController = UIWindow.keyWindow?.rootViewController { + let viewController = rootViewController.sm_selectPresentationContextTopDown(config) + return .viewController(Weak(value: viewController)) + } else { + throw SwiftMessagesError.noRootViewController + } + #endif + case .window: + let viewController = newWindowViewController() + return .viewController(Weak(value: viewController)) + case .windowScene: + let viewController = newWindowViewController() + return .viewController(Weak(value: viewController)) + case .viewController(let viewController): + let viewController = viewController.sm_selectPresentationContextBottomUp(config) + return .viewController(Weak(value: viewController)) + case .view(let view): + return .view(Weak(value: view)) + } + } + + /* + MARK: - Installation + */ + + func install() { + + func topLayoutConstraint(view: UIView, containerView: UIView, viewController: UIViewController?) -> NSLayoutConstraint { + if case .top = config.presentationStyle.topBottomStyle, let nav = viewController as? UINavigationController, nav.sm_isVisible(view: nav.navigationBar) { + return NSLayoutConstraint(item: view, attribute: .top, relatedBy: .equal, toItem: nav.navigationBar, attribute: .bottom, multiplier: 1.00, constant: 0.0) + } + return NSLayoutConstraint(item: view, attribute: .top, relatedBy: .equal, toItem: containerView, attribute: .top, multiplier: 1.00, constant: 0.0) + } + + func bottomLayoutConstraint(view: UIView, containerView: UIView, viewController: UIViewController?) -> NSLayoutConstraint { + if case .bottom = config.presentationStyle.topBottomStyle, let tab = viewController as? UITabBarController, tab.sm_isVisible(view: tab.tabBar) { + return NSLayoutConstraint(item: view, attribute: .bottom, relatedBy: .equal, toItem: tab.tabBar, attribute: .top, multiplier: 1.00, constant: 0.0) + } + return NSLayoutConstraint(item: view, attribute: .bottom, relatedBy: .equal, toItem: containerView, attribute: .bottom, multiplier: 1.00, constant: 0.0) + } + + func installMaskingView(containerView: UIView) { + maskingView.translatesAutoresizingMaskIntoConstraints = false + if let nav = presentationContext.viewControllerValue() as? UINavigationController { + containerView.insertSubview(maskingView, belowSubview: nav.navigationBar) + } else if let tab = presentationContext.viewControllerValue() as? UITabBarController { + containerView.insertSubview(maskingView, belowSubview: tab.tabBar) + } else { + containerView.addSubview(maskingView) + } + maskingView.leadingAnchor.constraint(equalTo: containerView.leadingAnchor).isActive = true + maskingView.trailingAnchor.constraint(equalTo: containerView.trailingAnchor).isActive = true + topLayoutConstraint(view: maskingView, containerView: containerView, viewController: presentationContext.viewControllerValue()).isActive = true + bottomLayoutConstraint(view: maskingView, containerView: containerView, viewController: presentationContext.viewControllerValue()).isActive = true + if let keyboardTrackingView = config.keyboardTrackingView { + maskingView.install(keyboardTrackingView: keyboardTrackingView) + } + // Update the container view's layout in order to know the masking view's frame + containerView.layoutIfNeeded() + } + + func installInteractive() { + guard config.dimMode.modal else { return } + if config.dimMode.interactive { + maskingView.tappedHander = { [weak self] in + guard let strongSelf = self else { return } + strongSelf.interactivelyHidden = true + strongSelf.delegate?.hide(presenter: strongSelf) + } + } else { + // There's no action to take, but the presence of + // a tap handler prevents interaction with underlying views. + maskingView.tappedHander = { } + } + } + + func installAccessibility() { + var elements: [NSObject] = [] + if let accessibleMessage = view as? AccessibleMessage { + if let message = accessibleMessage.accessibilityMessage { + let element = accessibleMessage.accessibilityElement ?? view + element.isAccessibilityElement = true + if element.accessibilityLabel == nil { + element.accessibilityLabel = message + } + elements.append(element) + } + if let additional = accessibleMessage.additionalAccessibilityElements { + elements += additional + } + } else { + elements += [view] + } + if config.dimMode.interactive { + let dismissView = UIView(frame: maskingView.bounds) + dismissView.translatesAutoresizingMaskIntoConstraints = true + dismissView.autoresizingMask = [.flexibleWidth, .flexibleHeight] + maskingView.addSubview(dismissView) + maskingView.sendSubviewToBack(dismissView) + dismissView.isUserInteractionEnabled = false + dismissView.isAccessibilityElement = true + dismissView.accessibilityLabel = config.dimModeAccessibilityLabel + dismissView.accessibilityTraits = UIAccessibilityTraits.button + elements.append(dismissView) + } + if config.dimMode.modal { + maskingView.accessibilityViewIsModal = true + } + maskingView.accessibleElements = elements + } + + guard let containerView = presentationContext.viewValue() else { return } + (presentationContext.viewControllerValue() as? WindowViewController)?.install() + installMaskingView(containerView: containerView) + installInteractive() + installAccessibility() + } +} + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/CardView.xib b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/CardView.xib new file mode 100644 index 0000000..425a696 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/CardView.xib @@ -0,0 +1,150 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/CenteredView.xib b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/CenteredView.xib new file mode 100644 index 0000000..a9fda2b --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/CenteredView.xib @@ -0,0 +1,153 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/MessageView.xib b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/MessageView.xib new file mode 100644 index 0000000..52ceaa7 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/MessageView.xib @@ -0,0 +1,104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/StatusLine.xib b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/StatusLine.xib new file mode 100644 index 0000000..3dbef99 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/StatusLine.xib @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/TabView.xib b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/TabView.xib new file mode 100644 index 0000000..141467c --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/TabView.xib @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon.png new file mode 100644 index 0000000..92f59e7 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon@2x.png new file mode 100644 index 0000000..2a0be86 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon@3x.png new file mode 100644 index 0000000..07a9e77 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIcon@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight.png new file mode 100644 index 0000000..bd00a52 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight@2x.png new file mode 100644 index 0000000..f4a5c66 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight@3x.png new file mode 100644 index 0000000..6360adb Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconLight@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle.png new file mode 100644 index 0000000..833f7c7 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle@2x.png new file mode 100644 index 0000000..0a6d0d9 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle@3x.png new file mode 100644 index 0000000..d15795b Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/errorIconSubtle@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon.png new file mode 100644 index 0000000..16a0cc7 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon@2x.png new file mode 100644 index 0000000..a1ab676 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon@3x.png new file mode 100644 index 0000000..fb98813 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIcon@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight.png new file mode 100644 index 0000000..9195a16 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight@2x.png new file mode 100644 index 0000000..4662af3 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight@3x.png new file mode 100644 index 0000000..999376e Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconLight@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle.png new file mode 100644 index 0000000..aa1a119 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle@2x.png new file mode 100644 index 0000000..901635d Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle@3x.png new file mode 100644 index 0000000..769fd02 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/infoIconSubtle@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon.png new file mode 100644 index 0000000..1d371c7 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon@2x.png new file mode 100644 index 0000000..719218c Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon@3x.png new file mode 100644 index 0000000..74893ca Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIcon@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight.png new file mode 100644 index 0000000..0e5314c Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight@2x.png new file mode 100644 index 0000000..149ab07 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight@3x.png new file mode 100644 index 0000000..5e15299 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconLight@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle.png new file mode 100644 index 0000000..6133483 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle@2x.png new file mode 100644 index 0000000..fbe6053 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle@3x.png new file mode 100644 index 0000000..6ce5379 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/successIconSubtle@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon.png new file mode 100644 index 0000000..7735761 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon@2x.png new file mode 100644 index 0000000..448d686 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon@3x.png new file mode 100644 index 0000000..e2c8d46 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIcon@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight.png new file mode 100644 index 0000000..fce1a0e Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight@2x.png new file mode 100644 index 0000000..91de0d9 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight@3x.png new file mode 100644 index 0000000..11d6859 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconLight@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle.png new file mode 100644 index 0000000..e54dcd3 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle@2x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle@2x.png new file mode 100644 index 0000000..cfd2ebd Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle@2x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle@3x.png b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle@3x.png new file mode 100644 index 0000000..9571567 Binary files /dev/null and b/Demo/Pods/SwiftMessages/SwiftMessages/Resources/warningIconSubtle@3x.png differ diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessages.Config+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessages.Config+Extensions.swift new file mode 100644 index 0000000..ac0475d --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessages.Config+Extensions.swift @@ -0,0 +1,44 @@ +// +// SwiftMessages.Config+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 12/26/20. +// Copyright © 2020 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +extension SwiftMessages.Config { + var windowLevel: UIWindow.Level? { + switch presentationContext { + case .window(let level): return level + case .windowScene(_, let level): return level + default: return nil + } + } + + @available (iOS 13.0, *) + var windowScene: UIWindowScene? { + switch presentationContext { + case .windowScene(let scene, _): return scene as? UIWindowScene + default: + #if SWIFTMESSAGES_APP_EXTENSIONS + return nil + #else + return UIWindow.keyWindow?.windowScene + #endif + } + } + + var shouldBecomeKeyWindow: Bool { + if let becomeKeyWindow = becomeKeyWindow { return becomeKeyWindow } + switch dimMode { + case .gray, .color, .blur: + // Should become key window in modal presentation style + // for proper VoiceOver handling. + return true + case .none: + return false + } + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessages.swift b/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessages.swift new file mode 100644 index 0000000..5e9f0c3 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessages.swift @@ -0,0 +1,962 @@ +// +// SwiftMessages.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/1/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +private let globalInstance = SwiftMessages() + +/** + The `SwiftMessages` class provides the interface for showing and hiding messages. + It behaves like a queue, only showing one message at a time. Message views that + adopt the `Identifiable` protocol (as `MessageView` does) will have duplicates removed. + */ +open class SwiftMessages { + + /** + Specifies whether the message view is displayed at the top or bottom + of the selected presentation container. + */ + public enum PresentationStyle { + + /** + Message view slides down from the top. + */ + case top + + /** + Message view slides up from the bottom. + */ + case bottom + + /** + Message view fades into the center. + */ + case center + + /** + User-defined animation + */ + case custom(animator: Animator) + } + + /** + Specifies how the container for presenting the message view + is selected. + */ + public enum PresentationContext { + + /** + Displays the message view under navigation bars and tab bars if an + appropriate one is found. Otherwise, it is displayed in a new window + at level `UIWindow.Level.normal`. Use this option to automatically display + under bars, where applicable. Because this option involves a top-down + search, an appropriate context might not be found when the view controller + hierarchy incorporates custom containers. If this is the case, the + .ViewController option can provide a more targeted context. + */ + case automatic + + /** + Displays the message in a new window at the specified window level. + SwiftMessages automatically increases the top margins of any message + view that adopts the `MarginInsetting` protocol (as `MessageView` does) + to account for the status bar. As of iOS 13, windows can no longer cover the + status bar. The only alternative is to set `Config.prefersStatusBarHidden = true` + to hide it. + */ + case window(windowLevel: UIWindow.Level) + + /** + Displays the message in a new window, at the specified window level, + in the specified window scene. SwiftMessages automatically increases the top margins + of any message view that adopts the `MarginInsetting` protocol (as `MessageView` does) + to account for the status bar. As of iOS 13, windows can no longer cover the + status bar. The only alternative is to set `Config.prefersStatusBarHidden = true` + to hide it. The `WindowScene` protocol works around the change in Xcode 13 that prevents + using `@availability` attribute with `enum` cases containing associated values. + */ + case windowScene(_: WindowScene, windowLevel: UIWindow.Level) + + /** + Displays the message view under navigation bars and tab bars if an + appropriate one is found using the given view controller as a starting + point and searching up the parent view controller chain. Otherwise, it + is displayed in the given view controller's view. This option can be used + for targeted placement in a view controller hierarchy. + */ + case viewController(_: UIViewController) + + /** + Displays the message view in the given container view. + */ + case view(_: UIView) + } + + /** + Specifies the duration of the message view's time on screen before it is + automatically hidden. + */ + public enum Duration { + + /** + Hide the message view after the default duration. + */ + case automatic + + /** + Disables automatic hiding of the message view. + */ + case forever + + /** + Hide the message view after the speficied number of seconds. + + - Parameter seconds: The number of seconds. + */ + case seconds(seconds: TimeInterval) + + /** + The `indefinite` option is similar to `forever` in the sense that + the message view will not be automatically hidden. However, it + provides two options that can be useful in some scenarios: + + - `delay`: wait the specified time interval before displaying + the message. If you hide the message during the delay + interval by calling either `hideAll()` or `hide(id:)`, + the message will not be displayed. This is not the case for + `hide()` because it only acts on a visible message. Messages + shown during another message's delay window are displayed first. + - `minimum`: if the message is displayed, ensure that it is displayed + for a minimum time interval. If you explicitly hide the + during this interval, the message will be hidden at the + end of the interval. + + This option is useful for displaying a message when a process is taking + too long but you don't want to display the message if the process completes + in a reasonable amount of time. The value `indefinite(delay: 0, minimum: 0)` + is equivalent to `forever`. + + For example, if a URL load is expected to complete in 2 seconds, you may use + the value `indefinite(delay: 2, minimum 1)` to ensure that the message will not + be displayed in most cases, but will be displayed for at least 1 second if + the operation takes longer than 2 seconds. By specifying a minimum duration, + you can avoid hiding the message too fast if the operation finishes right + after the delay interval. + */ + case indefinite(delay: TimeInterval, minimum: TimeInterval) + } + + /** + Specifies options for dimming the background behind the message view + similar to a popover view controller. + */ + public enum DimMode { + + /** + Don't dim the background behind the message view. + */ + case none + + /** + Dim the background behind the message view a gray color. + + - `interactive`: Specifies whether or not tapping the + dimmed area dismisses the message view. + */ + case gray(interactive: Bool) + + /** + Dim the background behind the message view using the given color. + SwiftMessages does not apply alpha transparency to the color, so any alpha + must be baked into the `UIColor` instance. + + - `color`: The color of the dim view. + - `interactive`: Specifies whether or not tapping the + dimmed area dismisses the message view. + */ + case color(color: UIColor, interactive: Bool) + + /** + Dim the background behind the message view using a blur effect with + the given style + + - `style`: The blur effect style to use + - `alpha`: The alpha level of the blur + - `interactive`: Specifies whether or not tapping the + dimmed area dismisses the message view. + */ + case blur(style: UIBlurEffect.Style, alpha: CGFloat, interactive: Bool) + + public var interactive: Bool { + switch self { + case .gray(let interactive): + return interactive + case .color(_, let interactive): + return interactive + case .blur (_, _, let interactive): + return interactive + case .none: + return false + } + } + + public var modal: Bool { + switch self { + case .gray, .color, .blur: + return true + case .none: + return false + } + } + } + + /** + Specifies events in the message lifecycle. + */ + public enum Event { + case willShow(UIView) + case didShow(UIView) + case willHide(UIView) + case didHide(UIView) + + public var view: UIView { + switch self { + case .willShow(let view): return view + case .didShow(let view): return view + case .willHide(let view): return view + case .didHide(let view): return view + } + } + + public var id: String? { + return (view as? Identifiable)?.id + } + } + + /** + A closure that takes an `Event` as an argument. + */ + public typealias EventListener = (Event) -> Void + + /** + The `Config` struct specifies options for displaying a single message view. It is + provided as an optional argument to one of the `MessageView.show()` methods. + */ + public struct Config { + + public init() {} + + /** + Specifies whether the message view is displayed at the top or bottom + of the selected presentation container. The default is `.Top`. + */ + public var presentationStyle = PresentationStyle.top + + /** + Specifies how the container for presenting the message view + is selected. The default is `.Automatic`. + */ + public var presentationContext = PresentationContext.automatic { + didSet { + if case .windowScene = presentationContext { + guard #available(iOS 13.0, *) else { + assertionFailure("windowScene is not supported below iOS 13.0.") + return + } + } + } + } + + /** + Specifies the duration of the message view's time on screen before it is + automatically hidden. The default is `.Automatic`. + */ + public var duration = Duration.automatic + + /** + Specifies options for dimming the background behind the message view + similar to a popover view controller. The default is `.None`. + */ + public var dimMode = DimMode.none + + /** + Specifies whether or not the interactive pan-to-hide gesture is enabled + on the message view. For views that implement the `BackgroundViewable` + protocol (as `MessageView` does), the pan gesture recognizer is installed + in the `backgroundView`, which allows for card-style views with transparent + margins that shouldn't be interactive. Otherwise, it is installed in + the message view itself. The default is `true`. + */ + public var interactiveHide = true + + /** + Specifies the preferred status bar style when the view is being + displayed in a window. This can be useful when the view is being + displayed behind the status bar and the message view has a background + color that needs a different status bar style than the current one. + The default is `nil`. + */ + public var preferredStatusBarStyle: UIStatusBarStyle? + + /** + Specifies the preferred status bar visibility when the view is being + displayed in a window. As of iOS 13, windows can no longer cover the + status bar. The only alternative is to hide the status bar by setting + this options to `true`. Default is `nil`. + */ + public var prefersStatusBarHidden: Bool? + + /** + If a view controller is created to host the message view, should the view + controller auto rotate? The default is 'true', meaning it should auto + rotate. + */ + public var shouldAutorotate = true + + /** + Specified whether or not duplicate `Identifiable` messages are ignored. + The default is `true`. + */ + public var ignoreDuplicates = true + + /** + Specifies an optional array of event listeners. + */ + public var eventListeners: [EventListener] = [] + + /** + Specifies that in cases where the message is displayed in its own window, + such as with `.window` presentation context, the window should become + the key window. This option should only be used if the message view + needs to receive non-touch events, such as keyboard input. From Apple's + documentation https://developer.apple.com/reference/uikit/uiwindow: + + > Whereas touch events are delivered to the window where they occurred, + > events that do not have a relevant coordinate value are delivered to + > the key window. Only one window at a time can be the key window, and + > you can use a window’s keyWindow property to determine its status. + > Most of the time, your app’s main window is the key window, but UIKit + > may designate a different window as needed. + */ + public var becomeKeyWindow: Bool? + + /** + The `dimMode` background will use this accessibility + label, e.g. "dismiss" when the `interactive` option is used. + */ + public var dimModeAccessibilityLabel: String = "dismiss" + + /** + The user interface style to use when SwiftMessages displays a message its own window. + Use with apps that don't support dark mode to prevent messages from adopting the + system's interface style. + */ + @available(iOS 13, *) + public var overrideUserInterfaceStyle: UIUserInterfaceStyle { + // Note that this is modelled as a computed property because + // Swift doesn't allow `@available` with stored properties. + get { + guard let rawValue = overrideUserInterfaceStyleRawValue else { return .unspecified } + return UIUserInterfaceStyle(rawValue: rawValue) ?? .unspecified + } + set { + overrideUserInterfaceStyleRawValue = newValue.rawValue + } + } + private var overrideUserInterfaceStyleRawValue: Int? + + /** + If specified, SwiftMessages calls this closure when an instance of + `WindowViewController` is needed. Use this if you need to supply a custom subclass + of `WindowViewController`. + */ + public var windowViewController: ((_ config: SwiftMessages.Config) -> WindowViewController)? + + /** + Supply an instance of `KeyboardTrackingView` to have the message view avoid the keyboard. + */ + public var keyboardTrackingView: KeyboardTrackingView? + } + + /** + Not much to say here. + */ + public init() {} + + /** + Adds the given configuration and view to the message queue to be displayed. + + - Parameter config: The configuration options. + - Parameter view: The view to be displayed. + */ + open func show(config: Config, view: UIView) { + let presenter = Presenter(config: config, view: view, delegate: self) + messageQueue.sync { + enqueue(presenter: presenter) + } + } + + /** + Adds the given view to the message queue to be displayed + with default configuration options. + + - Parameter config: The configuration options. + - Parameter view: The view to be displayed. + */ + public func show(view: UIView) { + show(config: defaultConfig, view: view) + } + + /// A block that returns an arbitrary view. + public typealias ViewProvider = () -> UIView + + /** + Adds the given configuration and view provider to the message queue to be displayed. + + The `viewProvider` block is guaranteed to be called on the main queue where + it is safe to interact with `UIKit` components. This variant of `show()` is + recommended when the message might be added from a background queue. + + - Parameter config: The configuration options. + - Parameter viewProvider: A block that returns the view to be displayed. + */ + open func show(config: Config, viewProvider: @escaping ViewProvider) { + DispatchQueue.main.async { [weak self] in + guard let strongSelf = self else { return } + let view = viewProvider() + strongSelf.show(config: config, view: view) + } + } + + /** + Adds the given view provider to the message queue to be displayed + with default configuration options. + + The `viewProvider` block is guaranteed to be called on the main queue where + it is safe to interact with `UIKit` components. This variant of `show()` is + recommended when the message might be added from a background queue. + + - Parameter viewProvider: A block that returns the view to be displayed. + */ + public func show(viewProvider: @escaping ViewProvider) { + show(config: defaultConfig, viewProvider: viewProvider) + } + + /** + Hide the current message being displayed by animating it away. + */ + open func hide(animated: Bool = true) { + messageQueue.sync { + hideCurrent(animated: animated) + } + } + + /** + Hide the current message, if there is one, by animating it away and + clear the message queue. + */ + open func hideAll() { + messageQueue.sync { + queue.removeAll() + delays.removeAll() + counts.removeAll() + hideCurrent() + } + } + + /** + Hide a message with the given `id`. If the specified message is + currently being displayed, it will be animated away. Works with message + views, such as `MessageView`, that adopt the `Identifiable` protocol. + - Parameter id: The identifier of the message to remove. + */ + open func hide(id: String) { + messageQueue.sync { + if id == _current?.id { + hideCurrent() + } + queue = queue.filter { $0.id != id } + delays.remove(id: id) + counts[id] = nil + } + } + + /** + Hide the message when the number of calls to show() and hideCounted(id:) for a + given message ID are equal. This can be useful for messages that may be + shown from multiple code paths to ensure that all paths are ready to hide. + */ + open func hideCounted(id: String) { + messageQueue.sync { + if let count = counts[id] { + if count < 2 { + counts[id] = nil + } else { + counts[id] = count - 1 + return + } + } + if id == _current?.id { + hideCurrent() + } + queue = queue.filter { $0.id != id } + delays.remove(id: id) + } + } + + /** + Get the count of a message with the given ID (see `hideCounted(id:)`) + */ + public func count(id: String) -> Int { + return counts[id] ?? 0 + } + + /** + Explicitly set the count of a message with the given ID (see `hideCounted(id:)`). + Not sure if there's a use case for this, but why not?! + */ + public func set(count: Int, for id: String) { + guard counts[id] != nil else { return } + return counts[id] = count + } + + /** + Specifies the default configuration to use when calling the variants of + `show()` that don't take a `config` argument or as a base for custom configs. + */ + public var defaultConfig = Config() + + /** + Specifies the amount of time to pause between removing a message + and showing the next. Default is 0.5 seconds. + */ + open var pauseBetweenMessages: TimeInterval = 0.5 + + /// Type for keeping track of delayed presentations + fileprivate class Delays { + + fileprivate func add(presenter: Presenter) { + presenters.insert(presenter) + } + + @discardableResult + fileprivate func remove(presenter: Presenter) -> Bool { + guard presenters.contains(presenter) else { return false } + presenters.remove(presenter) + return true + } + + fileprivate func remove(id: String) { + presenters = presenters.filter { $0.id != id } + } + + fileprivate func removeAll() { + presenters.removeAll() + } + + private var presenters = Set() + } + + func show(presenter: Presenter) { + messageQueue.sync { + enqueue(presenter: presenter) + } + } + + fileprivate let messageQueue = DispatchQueue(label: "it.swiftkick.SwiftMessages", attributes: []) + fileprivate var queue: [Presenter] = [] + fileprivate var delays = Delays() + fileprivate var counts: [String : Int] = [:] + fileprivate var _current: Presenter? = nil { + didSet { + if oldValue != nil { + let delayTime = DispatchTime.now() + pauseBetweenMessages + messageQueue.asyncAfter(deadline: delayTime) { [weak self] in + self?.dequeueNext() + } + } + } + } + + fileprivate func enqueue(presenter: Presenter) { + if presenter.config.ignoreDuplicates { + counts[presenter.id] = (counts[presenter.id] ?? 0) + 1 + if _current?.id == presenter.id && _current?.isHiding == false { return } + if queue.filter({ $0.id == presenter.id }).count > 0 { return } + } + func doEnqueue() { + queue.append(presenter) + dequeueNext() + } + if let delay = presenter.delayShow { + delays.add(presenter: presenter) + messageQueue.asyncAfter(deadline: .now() + delay) { [weak self] in + // Don't enqueue if the view has been hidden during the delay window. + guard let strongSelf = self, strongSelf.delays.remove(presenter: presenter) else { return } + doEnqueue() + } + } else { + doEnqueue() + } + } + + fileprivate func dequeueNext() { + guard self._current == nil, queue.count > 0 else { return } + let current = queue.removeFirst() + self._current = current + // Set `autohideToken` before the animation starts in case + // the dismiss gesture begins before we've queued the autohide + // block on animation completion. + self.autohideToken = current + current.showDate = CACurrentMediaTime() + DispatchQueue.main.async { [weak self] in + guard let strongSelf = self else { return } + do { + try current.show { completed in + guard let strongSelf = self else { return } + guard completed else { + strongSelf.messageQueue.sync { + strongSelf.internalHide(presenter: current) + } + return + } + if current === strongSelf.autohideToken { + strongSelf.queueAutoHide() + } + } + } catch { + strongSelf.messageQueue.sync { + strongSelf._current = nil + } + } + } + } + + fileprivate func internalHide(presenter: Presenter) { + if presenter == _current { + hideCurrent() + } else { + queue = queue.filter { $0 != presenter } + delays.remove(presenter: presenter) + } + } + + fileprivate func hideCurrent(animated: Bool = true) { + guard let current = _current, !current.isHiding else { return } + let action = { [weak self] in + current.hide(animated: animated) { (completed) in + guard completed, let strongSelf = self else { return } + strongSelf.messageQueue.sync { + guard strongSelf._current === current else { return } + strongSelf.counts[current.id] = nil + strongSelf._current = nil + } + } + } + let delay = current.delayHide ?? 0 + DispatchQueue.main.asyncAfter(deadline: .now() + delay) { + action() + } + } + + fileprivate weak var autohideToken: AnyObject? + + fileprivate func queueAutoHide() { + guard let current = _current else { return } + autohideToken = current + if let pauseDuration = current.pauseDuration { + let delayTime = DispatchTime.now() + pauseDuration + messageQueue.asyncAfter(deadline: delayTime, execute: { + // Make sure we've still got a green light to auto-hide. + if self.autohideToken !== current { return } + self.internalHide(presenter: current) + }) + } + } + + deinit { + // Prevent orphaned messages + hideCurrent() + } +} + +/* + MARK: - Accessing messages + */ + +extension SwiftMessages { + + /** + Returns the message view of type `T` if it is currently being shown or hidden. + + - Returns: The view of type `T` if it is currently being shown or hidden. + */ + public func current() -> T? { + var view: T? + messageQueue.sync { + view = _current?.view as? T + } + return view + } + + /** + Returns a message view with the given `id` if it is currently being shown or hidden. + + - Parameter id: The id of a message that adopts `Identifiable`. + - Returns: The view with matching id if currently being shown or hidden. + */ + public func current(id: String) -> T? { + var view: T? + messageQueue.sync { + if let current = _current, current.id == id { + view = current.view as? T + } + } + return view + } + + /** + Returns a message view with the given `id` if it is currently in the queue to be shown. + + - Parameter id: The id of a message that adopts `Identifiable`. + - Returns: The view with matching id if currently queued to be shown. + */ + public func queued(id: String) -> T? { + var view: T? + messageQueue.sync { + if let queued = queue.first(where: { $0.id == id }) { + view = queued.view as? T + } + } + return view + } + + /** + Returns a message view with the given `id` if it is currently being + shown, hidden or in the queue to be shown. + + - Parameter id: The id of a message that adopts `Identifiable`. + - Returns: The view with matching id if currently queued to be shown. + */ + public func currentOrQueued(id: String) -> T? { + return current(id: id) ?? queued(id: id) + } +} + +/* + MARK: - PresenterDelegate + */ + +extension SwiftMessages: PresenterDelegate { + + func hide(presenter: Presenter) { + messageQueue.sync { + self.internalHide(presenter: presenter) + } + } + + public func hide(animator: Animator) { + messageQueue.sync { + guard let presenter = self.presenter(forAnimator: animator) else { return } + self.internalHide(presenter: presenter) + } + } + + public func panStarted(animator: Animator) { + autohideToken = nil + } + + public func panEnded(animator: Animator) { + queueAutoHide() + } + + private func presenter(forAnimator animator: Animator) -> Presenter? { + if let current = _current, animator === current.animator { + return current + } + let queued = queue.filter { $0.animator === animator } + return queued.first + } +} + +/** + MARK: - Creating views from nibs + + This extension provides several convenience functions for instantiating views from nib files. + SwiftMessages provides several default nib files in the Resources folder that can be + drag-and-dropped into a project as a starting point and modified. + */ + +extension SwiftMessages { + + /** + Loads a nib file with the same name as the generic view type `T` and returns + the first view found in the nib file with matching type `T`. For example, if + the generic type is `MyView`, a nib file named `MyView.nib` is loaded and the + first top-level view of type `MyView` is returned. The main bundle is searched + first followed by the SwiftMessages bundle. + + - Parameter filesOwner: An optional files owner. + + - Throws: `Error.CannotLoadViewFromNib` if a view matching the + generic type `T` is not found in the nib. + + - Returns: An instance of generic view type `T`. + */ + public class func viewFromNib(_ filesOwner: AnyObject = NSNull.init()) throws -> T { + let name = T.description().components(separatedBy: ".").last + assert(name != nil) + let view: T = try internalViewFromNib(named: name!, bundle: nil, filesOwner: filesOwner) + return view + } + + /** + Loads a nib file with specified name and returns the first view found in the nib file + with matching type `T`. The main bundle is searched first followed by the SwiftMessages bundle. + + - Parameter name: The name of the nib file (excluding the .xib extension). + - Parameter filesOwner: An optional files owner. + + - Throws: `Error.CannotLoadViewFromNib` if a view matching the + generic type `T` is not found in the nib. + + - Returns: An instance of generic view type `T`. + */ + public class func viewFromNib(named name: String, filesOwner: AnyObject = NSNull.init()) throws -> T { + let view: T = try internalViewFromNib(named: name, bundle: nil, filesOwner: filesOwner) + return view + } + + /** + Loads a nib file with specified name in the specified bundle and returns the + first view found in the nib file with matching type `T`. + + - Parameter name: The name of the nib file (excluding the .xib extension). + - Parameter bundle: The name of the bundle containing the nib file. + - Parameter filesOwner: An optional files owner. + + - Throws: `Error.CannotLoadViewFromNib` if a view matching the + generic type `T` is not found in the nib. + + - Returns: An instance of generic view type `T`. + */ + public class func viewFromNib(named name: String, bundle: Bundle, filesOwner: AnyObject = NSNull.init()) throws -> T { + let view: T = try internalViewFromNib(named: name, bundle: bundle, filesOwner: filesOwner) + return view + } + + fileprivate class func internalViewFromNib(named name: String, bundle: Bundle? = nil, filesOwner: AnyObject = NSNull.init()) throws -> T { + let resolvedBundle: Bundle + if let bundle = bundle { + resolvedBundle = bundle + } else { + if Bundle.main.path(forResource: name, ofType: "nib") != nil { + resolvedBundle = Bundle.main + } else { + resolvedBundle = Bundle.sm_frameworkBundle() + } + } + let arrayOfViews = resolvedBundle.loadNibNamed(name, owner: filesOwner, options: nil) ?? [] + #if swift(>=4.1) + guard let view = arrayOfViews.compactMap( { $0 as? T} ).first else { throw SwiftMessagesError.cannotLoadViewFromNib(nibName: name) } + #else + guard let view = arrayOfViews.flatMap( { $0 as? T} ).first else { throw SwiftMessagesError.cannotLoadViewFromNib(nibName: name) } + #endif + return view + } +} + +/* + MARK: - Static APIs + + This extension provides a shared instance of `SwiftMessages` and a static API wrapper around + this instance for simplified syntax. For example, `SwiftMessages.show()` is equivalent + to `SwiftMessages.sharedInstance.show()`. + */ + +extension SwiftMessages { + + /** + A default shared instance of `SwiftMessages`. The `SwiftMessages` class provides + a set of static APIs that wrap calls to this instance. For example, `SwiftMessages.show()` + is equivalent to `SwiftMessages.sharedInstance.show()`. + */ + public static var sharedInstance: SwiftMessages { + return globalInstance + } + + public static func show(viewProvider: @escaping ViewProvider) { + globalInstance.show(viewProvider: viewProvider) + } + + public static func show(config: Config, viewProvider: @escaping ViewProvider) { + globalInstance.show(config: config, viewProvider: viewProvider) + } + + public static func show(view: UIView) { + globalInstance.show(view: view) + } + + public static func show(config: Config, view: UIView) { + globalInstance.show(config: config, view: view) + } + + public static func hide(animated: Bool = true) { + globalInstance.hide(animated: animated) + } + + public static func hideAll() { + globalInstance.hideAll() + } + + public static func hide(id: String) { + globalInstance.hide(id: id) + } + + public static func hideCounted(id: String) { + globalInstance.hideCounted(id: id) + } + + public static var defaultConfig: Config { + get { + return globalInstance.defaultConfig + } + set { + globalInstance.defaultConfig = newValue + } + } + + public static var pauseBetweenMessages: TimeInterval { + get { + return globalInstance.pauseBetweenMessages + } + set { + globalInstance.pauseBetweenMessages = newValue + } + } + + public static func current(id: String) -> T? { + return globalInstance.current(id: id) + } + + public static func queued(id: String) -> T? { + return globalInstance.queued(id: id) + } + + public static func currentOrQueued(id: String) -> T? { + return globalInstance.currentOrQueued(id: id) + } + + public static func count(id: String) -> Int { + return globalInstance.count(id: id) + } + + public static func set(count: Int, for id: String) { + globalInstance.set(count: count, for: id) + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessagesSegue.swift b/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessagesSegue.swift new file mode 100644 index 0000000..d4cba41 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/SwiftMessagesSegue.swift @@ -0,0 +1,399 @@ +// +// SwiftMessagesSegue.swift +// SwiftMessages +// +// Created by Timothy Moose on 5/30/18. +// Copyright © 2018 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +/** + `SwiftMessagesSegue` is a configurable subclass of `UIStoryboardSegue` that utilizes + SwiftMessages to present and dismiss modal view controllers. It performs these transitions by + becoming your view controller's `transitioningDelegate` and calling SwiftMessage's `show()` + and `hide()` under the hood. + + To use `SwiftMessagesSegue` with Interface Builder, control-drag a segue, then select + "swift messages" from the Segue Type dialog. This configures a default transition. There are + two suggested ways to further configure the transition by setting options on `SwiftMessagesSegue`. + First, and recommended, you may subclass `SwiftMessagesSegue` and override `init(identifier:source:destination:)`. + Subclasses will automatically appear in the segue type dialog using an auto-generated name (for example, the + name for "VeryNiceSegue" would be "very nice"). Second, you may override `prepare(for:sender:)` in the + presenting view controller and downcast the segue to `SwiftMessagesSegue`. + + `SwiftMessagesSegue` can be used without an associated storyboard or segue by doing the following in + the presenting view controller. + + let destinationVC = ... // make a reference to a destination view controller + let segue = SwiftMessagesSegue(identifier: nil, source: self, destination: destinationVC) + ... // do any configuration here + segue.perform() + + To dismiss, call the UIKit API on the presenting view controller: + + dismiss(animated: true, completion: nil) + + It is not necessary to retain `segue` because it retains itself until dismissal. However, you can + retain it if you plan to `perform()` more than once. + + #### Present the controller on top of all controllers + + If you don't know the presenter or you don't want to pass it as a source, like when you + have a completely separated message controller, you can pass a `WindowViewController` + as the `source` argument of the segue's initializer. + + By default, the window will be shown in the current window scene at `.normal` window level. + However, these parameters can be customized by initializing the view controller with a `SwiftMessages.Config` that has the `SwiftMessages.Config.presentationContext` set to either `.window` or `.windowScene`: + + + note: Some additional details: + 1. Your view controller's view will be embedded in a `SwiftMessages.BaseView` in order to + utilize some SwiftMessages features. This view can be accessed and configured via the + `SwiftMessagesSegue.messageView` property. For example, you may configure a default drop + shadow by calling `segue.messageView.configureDropShadow()`. + 2. SwiftMessagesSegue provides static default view controller sizing based on device. + However, it is recommended that you specify sizing appropriate for your content using + one of the following methods. + 1. Define sufficient width and height constraints in your view controller. + 2. Set `preferredContentSize` (a.k.a "Use Preferred Explicit Size" in Interface Builder's + attribute inspector). Zeros are ignored, e.g. `CGSize(width: 0, height: 350)` only + affects the height. + 3. Add explicit width and/or height constraints to `segue.messageView.backgroundView`. + Note that `Layout.topMessage` and `Layout.bottomMessage` are always full screen width. + For other layouts, the there is a maximum 500pt width on iPad (regular horizontal size class) + at 950 priority, which can be overridden by adding higher-priority constraints. + + See the "View Controllers" selection in the Demo app for examples. + */ + +open class SwiftMessagesSegue: UIStoryboardSegue { + + /** + Specifies one of the pre-defined layouts, mirroring a subset of `MessageView.Layout`. + */ + public enum Layout { + + /// The standard message view layout on top. + case topMessage + + /// The standard message view layout on bottom. + case bottomMessage + + /// A floating card-style view with rounded corners on top + case topCard + + /// A floating tab-style view with rounded corners on bottom + case topTab + + /// A floating card-style view with rounded corners on bottom + case bottomCard + + /// A floating tab-style view with rounded corners on top + case bottomTab + + /// A floating card-style view typically used with `.center` presentation style. + case centered + } + + /** + Specifies how the view controller's view is installed into the + containing message view. + */ + public enum Containment { + + /** + The view controller's view is installed for edge-to-edge display, extending into the safe areas + to the device edges. This is done by calling `messageView.installContentView(:insets:)` + See that method's documentation for additional details. + */ + case content + + /** + The view controller's view is installed for card-style layouts, inset from the margins + and avoiding safe areas. This is done by calling `messageView.installBackgroundView(:insets:)`. + See that method's documentation for details. + */ + case background + + /** + The view controller's view is installed for tab-style layouts, inset from the side margins, but extending + to the device edge on the top or bottom. This is done by calling `messageView.installBackgroundVerticalView(:insets:)`. + See that method's documentation for details. + */ + case backgroundVertical + } + + /// The presentation style to use. See the SwiftMessages.PresentationStyle for details. + public var presentationStyle: SwiftMessages.PresentationStyle { + get { return messenger.defaultConfig.presentationStyle } + set { messenger.defaultConfig.presentationStyle = newValue } + } + + /// The dim mode to use. See the SwiftMessages.DimMode for details. + public var dimMode: SwiftMessages.DimMode { + get { return messenger.defaultConfig.dimMode} + set { messenger.defaultConfig.dimMode = newValue } + } + + // duration + public var duration: SwiftMessages.Duration { + get { return messenger.defaultConfig.duration} + set { messenger.defaultConfig.duration = newValue } + } + + /// Specifies whether or not the interactive pan-to-hide gesture is enabled + /// on the message view. The default value is `true`, but may not be appropriate + /// for view controllers that use swipe or pan gestures. + public var interactiveHide: Bool { + get { return messenger.defaultConfig.interactiveHide } + set { messenger.defaultConfig.interactiveHide = newValue } + } + + /// Specifies an optional array of event listeners. + public var eventListeners: [SwiftMessages.EventListener] { + get { return messenger.defaultConfig.eventListeners } + set { messenger.defaultConfig.eventListeners = newValue } + } + + /** + Normally, the destination view controller's `modalPresentationStyle` is changed + to `.custom` in the `perform()` function. Set this property to `false` to prevent it from + being overridden. + */ + public var overrideModalPresentationStyle: Bool = true + + /** + The view that is passed to `SwiftMessages.show(config:view:)` during presentation. + The view controller's view is installed into `containerView`, which is itself installed + into `messageView`. `SwiftMessagesSegue` does this installation automatically based on the + value of the `containment` property. `BaseView` is the parent of `MessageView` and provides a + number of configuration options that you may use. For example, you may configure a default drop + shadow by calling `messageView.configureDropShadow()`. + */ + public var messageView = BaseView() + + /** + The view controller's view is embedded in `containerView` before being installed into + `messageView`. This view provides configurable squircle (round) corners (see the parent + class `CornerRoundingView`). + */ + public var containerView: CornerRoundingView = CornerRoundingView() + + /** + Specifies how the view controller's view is installed into the + containing message view. See `Containment` for details. + */ + public var containment: Containment = .content + + /** + Supply an instance of `KeyboardTrackingView` to have the message view avoid the keyboard. + */ + public var keyboardTrackingView: KeyboardTrackingView? { + get { + return messenger.defaultConfig.keyboardTrackingView + } + set { + messenger.defaultConfig.keyboardTrackingView = newValue + } + } + + private var messenger = SwiftMessages() + private var selfRetainer: SwiftMessagesSegue? = nil + private lazy var hider = { return TransitioningDismisser(segue: self) }() + + private lazy var presenter = { + return Presenter(config: messenger.defaultConfig, view: messageView, delegate: messenger) + }() + + override open func perform() { + (source as? WindowViewController)?.install() + selfRetainer = self + if overrideModalPresentationStyle { + destination.modalPresentationStyle = .custom + } + destination.transitioningDelegate = self + source.present(destination, animated: true, completion: nil) + } + + override public init(identifier: String?, source: UIViewController, destination: UIViewController) { + super.init(identifier: identifier, source: source, destination: destination) + dimMode = .gray(interactive: true) + messenger.defaultConfig.duration = .forever + } + + fileprivate let safeAreaWorkaroundViewController = UIViewController() +} + +extension SwiftMessagesSegue { + /// A convenience method for configuring some pre-defined layouts that mirror a subset of `MessageView.Layout`. + public func configure(layout: Layout) { + messageView.bounceAnimationOffset = 0 + containment = .content + containerView.cornerRadius = 0 + containerView.roundsLeadingCorners = false + messageView.configureDropShadow() + switch layout { + case .topMessage: + messageView.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) + messageView.collapseLayoutMarginAdditions = false + let animation = TopBottomAnimation(style: .top) + animation.springDamping = 1 + presentationStyle = .custom(animator: animation) + case .bottomMessage: + messageView.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20) + messageView.collapseLayoutMarginAdditions = false + let animation = TopBottomAnimation(style: .bottom) + animation.springDamping = 1 + presentationStyle = .custom(animator: animation) + case .topCard: + containment = .background + messageView.layoutMarginAdditions = UIEdgeInsets(top: 10, left: 10, bottom: 10, right: 10) + messageView.collapseLayoutMarginAdditions = true + containerView.cornerRadius = 15 + presentationStyle = .top + case .bottomCard: + containment = .background + messageView.layoutMarginAdditions = UIEdgeInsets(top: 10, left: 10, bottom: 10, right: 10) + messageView.collapseLayoutMarginAdditions = true + containerView.cornerRadius = 15 + presentationStyle = .bottom + case .topTab: + containment = .backgroundVertical + messageView.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 10, bottom: 20, right: 10) + messageView.collapseLayoutMarginAdditions = true + containerView.cornerRadius = 15 + containerView.roundsLeadingCorners = true + let animation = TopBottomAnimation(style: .top) + animation.springDamping = 1 + presentationStyle = .custom(animator: animation) + case .bottomTab: + containment = .backgroundVertical + messageView.layoutMarginAdditions = UIEdgeInsets(top: 20, left: 10, bottom: 20, right: 10) + messageView.collapseLayoutMarginAdditions = true + containerView.cornerRadius = 15 + containerView.roundsLeadingCorners = true + let animation = TopBottomAnimation(style: .bottom) + animation.springDamping = 1 + presentationStyle = .custom(animator: animation) + case .centered: + containment = .background + messageView.layoutMarginAdditions = UIEdgeInsets(top: 10, left: 10, bottom: 10, right: 10) + messageView.collapseLayoutMarginAdditions = true + containerView.cornerRadius = 15 + presentationStyle = .center + } + } +} + +extension SwiftMessagesSegue: UIViewControllerTransitioningDelegate { + public func animationController(forPresented presented: UIViewController, presenting: UIViewController, source: UIViewController) -> UIViewControllerAnimatedTransitioning? { + let shower = TransitioningPresenter(segue: self) + messenger.defaultConfig.eventListeners.append { [unowned self] in + switch $0 { + case .didShow: + shower.completeTransition?(true) + case .didHide: + if let completeTransition = self.hider.completeTransition { + completeTransition(true) + } else { + // Case where message is internally hidden by SwiftMessages, such as with a + // dismiss gesture, rather than by view controller dismissal. + source.dismiss(animated: false, completion: nil) + } + (source as? WindowViewController)?.uninstall() + self.selfRetainer = nil + default: break + } + } + return shower + } + + public func animationController(forDismissed dismissed: UIViewController) -> UIViewControllerAnimatedTransitioning? { + return hider + } +} + +extension SwiftMessagesSegue { + private class TransitioningPresenter: NSObject, UIViewControllerAnimatedTransitioning { + + fileprivate private(set) var completeTransition: ((Bool) -> Void)? + private weak var segue: SwiftMessagesSegue? + + fileprivate init(segue: SwiftMessagesSegue) { + self.segue = segue + } + + func transitionDuration(using transitionContext: UIViewControllerContextTransitioning?) -> TimeInterval { + return segue?.presenter.animator.showDuration ?? 0.5 + } + + func animateTransition(using transitionContext: UIViewControllerContextTransitioning) { + guard let segue = segue, + let toView = transitionContext.view(forKey: .to) else { + transitionContext.completeTransition(false) + return + } + if #available(iOS 12, *) {} + else if #available(iOS 11.0, *) { + // This works around a bug in iOS 11 where the safe area of `messageView` ( + // and all ancestor views) is not set except on iPhone X. By assigning `messageView` + // to a view controller, its safe area is set consistently. This bug has been resolved as + // of Xcode 10 beta 2. + segue.safeAreaWorkaroundViewController.view = segue.presenter.maskingView + } + completeTransition = transitionContext.completeTransition + let transitionContainer = transitionContext.containerView + toView.translatesAutoresizingMaskIntoConstraints = false + segue.containerView.addSubview(toView) + segue.containerView.topAnchor.constraint(equalTo: toView.topAnchor).isActive = true + segue.containerView.bottomAnchor.constraint(equalTo: toView.bottomAnchor).isActive = true + segue.containerView.leadingAnchor.constraint(equalTo: toView.leadingAnchor).isActive = true + segue.containerView.trailingAnchor.constraint(equalTo: toView.trailingAnchor).isActive = true + // Install the `toView` into the message view. + switch segue.containment { + case .content: + segue.messageView.installContentView(segue.containerView) + case .background: + segue.messageView.installBackgroundView(segue.containerView) + case .backgroundVertical: + segue.messageView.installBackgroundVerticalView(segue.containerView) + } + let toVC = transitionContext.viewController(forKey: .to) + if let preferredHeight = toVC?.preferredContentSize.height, + preferredHeight > 0 { + segue.containerView.heightAnchor.constraint(equalToConstant: preferredHeight).with(priority: UILayoutPriority(rawValue: 951)).isActive = true + } + if let preferredWidth = toVC?.preferredContentSize.width, + preferredWidth > 0 { + segue.containerView.widthAnchor.constraint(equalToConstant: preferredWidth).with(priority: UILayoutPriority(rawValue: 951)).isActive = true + } + segue.presenter.config.presentationContext = .view(transitionContainer) + segue.messenger.show(presenter: segue.presenter) + } + } +} + +extension SwiftMessagesSegue { + private class TransitioningDismisser: NSObject, UIViewControllerAnimatedTransitioning { + + fileprivate private(set) var completeTransition: ((Bool) -> Void)? + private weak var segue: SwiftMessagesSegue? + + fileprivate init(segue: SwiftMessagesSegue) { + self.segue = segue + } + + func transitionDuration(using transitionContext: UIViewControllerContextTransitioning?) -> TimeInterval { + return segue?.presenter.animator.hideDuration ?? 0.5 + } + + func animateTransition(using transitionContext: UIViewControllerContextTransitioning) { + guard let messenger = segue?.messenger else { + transitionContext.completeTransition(false) + return + } + completeTransition = transitionContext.completeTransition + messenger.hide() + } + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Theme.swift b/Demo/Pods/SwiftMessages/SwiftMessages/Theme.swift new file mode 100644 index 0000000..5bf10a4 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Theme.swift @@ -0,0 +1,67 @@ +// +// Theme.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/7/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +/// The theme enum specifies the built-in theme options +public enum Theme { + case info + case success + case warning + case error +} + +/// The Icon enum provides type-safe access to the included icons. +public enum Icon: String { + + case error = "errorIcon" + case warning = "warningIcon" + case success = "successIcon" + case info = "infoIcon" + case errorLight = "errorIconLight" + case warningLight = "warningIconLight" + case successLight = "successIconLight" + case infoLight = "infoIconLight" + case errorSubtle = "errorIconSubtle" + case warningSubtle = "warningIconSubtle" + case successSubtle = "successIconSubtle" + case infoSubtle = "infoIconSubtle" + + /// Returns the associated image. + public var image: UIImage { + return UIImage(named: rawValue, in: Bundle.sm_frameworkBundle(), compatibleWith: nil)!.withRenderingMode(.alwaysTemplate) + } +} + +/// The IconStyle enum specifies the different variations of the included icons. +public enum IconStyle { + + case `default` + case light + case subtle + case none + + /// Returns the image for the given theme + public func image(theme: Theme) -> UIImage? { + switch (theme, self) { + case (.info, .default): return Icon.info.image + case (.info, .light): return Icon.infoLight.image + case (.info, .subtle): return Icon.infoSubtle.image + case (.success, .default): return Icon.success.image + case (.success, .light): return Icon.successLight.image + case (.success, .subtle): return Icon.successSubtle.image + case (.warning, .default): return Icon.warning.image + case (.warning, .light): return Icon.warningLight.image + case (.warning, .subtle): return Icon.warningSubtle.image + case (.error, .default): return Icon.error.image + case (.error, .light): return Icon.errorLight.image + case (.error, .subtle): return Icon.errorSubtle.image + default: return nil + } + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/TopBottomAnimation.swift b/Demo/Pods/SwiftMessages/SwiftMessages/TopBottomAnimation.swift new file mode 100644 index 0000000..21b0f27 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/TopBottomAnimation.swift @@ -0,0 +1,233 @@ +// +// TopBottomAnimation.swift +// SwiftMessages +// +// Created by Timothy Moose on 6/4/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +public class TopBottomAnimation: NSObject, Animator { + + public enum Style { + case top + case bottom + } + + public weak var delegate: AnimationDelegate? + + public let style: Style + + public var showDuration: TimeInterval = 0.4 + + public var hideDuration: TimeInterval = 0.2 + + public var springDamping: CGFloat = 0.8 + + public var closeSpeedThreshold: CGFloat = 750.0; + + public var closePercentThreshold: CGFloat = 0.33; + + public var closeAbsoluteThreshold: CGFloat = 75.0; + + public private(set) lazy var panGestureRecognizer: UIPanGestureRecognizer = { + let pan = UIPanGestureRecognizer() + pan.addTarget(self, action: #selector(pan(_:))) + return pan + }() + + weak var messageView: UIView? + weak var containerView: UIView? + var context: AnimationContext? + + public init(style: Style) { + self.style = style + } + + init(style: Style, delegate: AnimationDelegate) { + self.style = style + self.delegate = delegate + } + + public func show(context: AnimationContext, completion: @escaping AnimationCompletion) { + NotificationCenter.default.addObserver(self, selector: #selector(adjustMargins), name: UIDevice.orientationDidChangeNotification, object: nil) + install(context: context) + showAnimation(completion: completion) + } + + public func hide(context: AnimationContext, completion: @escaping AnimationCompletion) { + NotificationCenter.default.removeObserver(self) + let view = context.messageView + self.context = context + UIView.animate(withDuration: hideDuration, delay: 0, options: [.beginFromCurrentState, .curveEaseIn], animations: { + switch self.style { + case .top: + view.transform = CGAffineTransform(translationX: 0, y: -view.frame.height) + case .bottom: + view.transform = CGAffineTransform(translationX: 0, y: view.frame.maxY + view.frame.height) + } + }, completion: { completed in + #if SWIFTMESSAGES_APP_EXTENSIONS + completion(completed) + #else + // Fix #131 by always completing if application isn't active. + completion(completed || UIApplication.shared.applicationState != .active) + #endif + }) + } + + func install(context: AnimationContext) { + let view = context.messageView + let container = context.containerView + messageView = view + containerView = container + self.context = context + if let adjustable = context.messageView as? MarginAdjustable { + bounceOffset = adjustable.bounceAnimationOffset + } + view.translatesAutoresizingMaskIntoConstraints = false + container.addSubview(view) + view.leadingAnchor.constraint(equalTo: container.leadingAnchor).isActive = true + view.trailingAnchor.constraint(equalTo: container.trailingAnchor).isActive = true + switch style { + case .top: + view.topAnchor.constraint(equalTo: container.topAnchor, constant: -bounceOffset).with(priority: UILayoutPriority(200)).isActive = true + case .bottom: + view.bottomAnchor.constraint(equalTo: container.bottomAnchor, constant: bounceOffset).with(priority: UILayoutPriority(200)).isActive = true + } + // Important to layout now in order to get the right safe area insets + container.layoutIfNeeded() + adjustMargins() + container.layoutIfNeeded() + let animationDistance = view.frame.height + switch style { + case .top: + view.transform = CGAffineTransform(translationX: 0, y: -animationDistance) + case .bottom: + view.transform = CGAffineTransform(translationX: 0, y: animationDistance) + } + if context.interactiveHide { + if let view = view as? BackgroundViewable { + view.backgroundView.addGestureRecognizer(panGestureRecognizer) + } else { + view.addGestureRecognizer(panGestureRecognizer) + } + } + if let view = view as? BackgroundViewable, + let cornerRoundingView = view.backgroundView as? CornerRoundingView, + cornerRoundingView.roundsLeadingCorners { + switch style { + case .top: + cornerRoundingView.roundedCorners = [.bottomLeft, .bottomRight] + case .bottom: + cornerRoundingView.roundedCorners = [.topLeft, .topRight] + } + } + } + + @objc public func adjustMargins() { + guard let adjustable = messageView as? MarginAdjustable & UIView, + let context = context else { return } + adjustable.preservesSuperviewLayoutMargins = false + if #available(iOS 11, *) { + adjustable.insetsLayoutMarginsFromSafeArea = false + } + var layoutMargins = adjustable.defaultMarginAdjustment(context: context) + switch style { + case .top: + layoutMargins.top += bounceOffset + case .bottom: + layoutMargins.bottom += bounceOffset + } + adjustable.layoutMargins = layoutMargins + } + + func showAnimation(completion: @escaping AnimationCompletion) { + guard let view = messageView else { + completion(false) + return + } + let animationDistance = abs(view.transform.ty) + // Cap the initial velocity at zero because the bounceOffset may not be great + // enough to allow for greater bounce induced by a quick panning motion. + let initialSpringVelocity = animationDistance == 0.0 ? 0.0 : min(0.0, closeSpeed / animationDistance) + UIView.animate(withDuration: showDuration, delay: 0.0, usingSpringWithDamping: springDamping, initialSpringVelocity: initialSpringVelocity, options: [.beginFromCurrentState, .curveLinear, .allowUserInteraction], animations: { + view.transform = .identity + }, completion: { completed in + // Fix #131 by always completing if application isn't active. + #if SWIFTMESSAGES_APP_EXTENSIONS + completion(completed) + #else + completion(completed || UIApplication.shared.applicationState != .active) + #endif + }) + } + + fileprivate var bounceOffset: CGFloat = 5 + + /* + MARK: - Pan to close + */ + + fileprivate var closing = false + fileprivate var rubberBanding = false + fileprivate var closeSpeed: CGFloat = 0.0 + fileprivate var closePercent: CGFloat = 0.0 + fileprivate var panTranslationY: CGFloat = 0.0 + + @objc func pan(_ pan: UIPanGestureRecognizer) { + switch pan.state { + case .changed: + guard let view = messageView else { return } + let height = view.bounds.height - bounceOffset + if height <= 0 { return } + var velocity = pan.velocity(in: view) + var translation = pan.translation(in: view) + if case .top = style { + velocity.y *= -1.0 + translation.y *= -1.0 + } + var translationAmount = translation.y >= 0 ? translation.y : -pow(abs(translation.y), 0.7) + if !closing { + // Turn on rubber banding if background view is inset from message view. + if let background = (messageView as? BackgroundViewable)?.backgroundView, background != view { + switch style { + case .top: + rubberBanding = background.frame.minY > 0 + case .bottom: + rubberBanding = background.frame.maxY < view.bounds.height + } + } + if !rubberBanding && translationAmount < 0 { return } + closing = true + delegate?.panStarted(animator: self) + } + if !rubberBanding && translationAmount < 0 { translationAmount = 0 } + switch style { + case .top: + view.transform = CGAffineTransform(translationX: 0, y: -translationAmount) + case .bottom: + view.transform = CGAffineTransform(translationX: 0, y: translationAmount) + } + closeSpeed = velocity.y + closePercent = translation.y / height + panTranslationY = translation.y + case .ended, .cancelled: + if closeSpeed > closeSpeedThreshold || closePercent > closePercentThreshold || panTranslationY > closeAbsoluteThreshold { + delegate?.hide(animator: self) + } else { + closing = false + rubberBanding = false + closeSpeed = 0.0 + closePercent = 0.0 + panTranslationY = 0.0 + showAnimation(completion: { (completed) in + self.delegate?.panEnded(animator: self) + }) + } + default: + break + } + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/UIEdgeInsets+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/UIEdgeInsets+Extensions.swift new file mode 100644 index 0000000..19bbe4e --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/UIEdgeInsets+Extensions.swift @@ -0,0 +1,27 @@ +// +// UIEdgeInsets+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 5/23/18. +// Copyright © 2018 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +extension UIEdgeInsets { + public static func +(left: UIEdgeInsets, right: UIEdgeInsets) -> UIEdgeInsets { + let topSum = left.top + right.top + let leftSum = left.left + right.left + let bottomSum = left.bottom + right.bottom + let rightSum = left.right + right.right + return UIEdgeInsets(top: topSum, left: leftSum, bottom: bottomSum, right: rightSum) + } + + public static func -(left: UIEdgeInsets, right: UIEdgeInsets) -> UIEdgeInsets { + let topSum = left.top - right.top + let leftSum = left.left - right.left + let bottomSum = left.bottom - right.bottom + let rightSum = left.right - right.right + return UIEdgeInsets(top: topSum, left: leftSum, bottom: bottomSum, right: rightSum) + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/UIViewController+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/UIViewController+Extensions.swift new file mode 100644 index 0000000..7fbd4dd --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/UIViewController+Extensions.swift @@ -0,0 +1,101 @@ +// +// UIViewController+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/5/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +extension UIViewController { + + func sm_selectPresentationContextTopDown(_ config: SwiftMessages.Config) -> UIViewController { + let topBottomStyle = config.presentationStyle.topBottomStyle + if let presented = presentedViewController { + return presented.sm_selectPresentationContextTopDown(config) + } else if case .top? = topBottomStyle, let navigationController = sm_selectNavigationControllerTopDown() { + return navigationController + } else if case .bottom? = topBottomStyle, let tabBarController = sm_selectTabBarControllerTopDown() { + return tabBarController + } + return WindowViewController.newInstance(config: config) + } + + fileprivate func sm_selectNavigationControllerTopDown() -> UINavigationController? { + if let presented = presentedViewController { + return presented.sm_selectNavigationControllerTopDown() + } else if let navigationController = self as? UINavigationController { + if navigationController.sm_isVisible(view: navigationController.navigationBar) { + return navigationController + } + return navigationController.topViewController?.sm_selectNavigationControllerTopDown() + } else if let tabBarController = self as? UITabBarController { + return tabBarController.selectedViewController?.sm_selectNavigationControllerTopDown() + } + return nil + } + + fileprivate func sm_selectTabBarControllerTopDown() -> UITabBarController? { + if let presented = presentedViewController { + return presented.sm_selectTabBarControllerTopDown() + } else if let navigationController = self as? UINavigationController { + return navigationController.topViewController?.sm_selectTabBarControllerTopDown() + } else if let tabBarController = self as? UITabBarController { + if tabBarController.sm_isVisible(view: tabBarController.tabBar) { + return tabBarController + } + return tabBarController.selectedViewController?.sm_selectTabBarControllerTopDown() + } + return nil + } + + func sm_selectPresentationContextBottomUp(_ config: SwiftMessages.Config) -> UIViewController { + let topBottomStyle = config.presentationStyle.topBottomStyle + if let parent = parent { + if let navigationController = parent as? UINavigationController { + if case .top? = topBottomStyle, navigationController.sm_isVisible(view: navigationController.navigationBar) { + return navigationController + } + return navigationController.sm_selectPresentationContextBottomUp(config) + } else if let tabBarController = parent as? UITabBarController { + if case .bottom? = topBottomStyle, tabBarController.sm_isVisible(view: tabBarController.tabBar) { + return tabBarController + } + return tabBarController.sm_selectPresentationContextBottomUp(config) + } + } + if self.view is UITableView { + // Never select scroll view as presentation context + // because, you know, it scrolls. + if let parent = self.parent { + return parent.sm_selectPresentationContextBottomUp(config) + } else { + return WindowViewController.newInstance(config: config) + } + } + return self + } + + func sm_isVisible(view: UIView) -> Bool { + if view.isHidden { return false } + if view.alpha == 0.0 { return false } + let frame = self.view.convert(view.bounds, from: view) + if !self.view.bounds.intersects(frame) { return false } + return true + } +} + +extension SwiftMessages.PresentationStyle { + /// A temporary workaround to allow custom presentation contexts using `TopBottomAnimation` + /// to display properly behind bars. THe long term solution is to refactor all of the + /// presentation context logic to work with safe area insets. + var topBottomStyle: TopBottomAnimation.Style? { + switch self { + case .top: return .top + case .bottom: return .bottom + case .custom(let animator): return (animator as? TopBottomAnimation)?.style + case .center: return nil + } + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/UIWindow+Extensions.swift b/Demo/Pods/SwiftMessages/SwiftMessages/UIWindow+Extensions.swift new file mode 100644 index 0000000..316fcac --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/UIWindow+Extensions.swift @@ -0,0 +1,38 @@ +// +// UIWindow+Extensions.swift +// SwiftMessages +// +// Created by Timothy Moose on 3/11/21. +// Copyright © 2021 SwiftKick Mobile. All rights reserved. +// + +import UIKit + +extension UIWindow { + #if !SWIFTMESSAGES_APP_EXTENSIONS + static var keyWindow: UIWindow? { + if #available(iOS 13.0, *) { + return UIApplication.shared.connectedScenes + .sorted { $0.activationState.sortPriority < $1.activationState.sortPriority } + .compactMap { $0 as? UIWindowScene } + .compactMap { $0.windows.first { $0.isKeyWindow } } + .first + } else { + return UIApplication.shared.keyWindow + } + } + #endif +} + +@available(iOS 13.0, *) +private extension UIScene.ActivationState { + var sortPriority: Int { + switch self { + case .foregroundActive: return 1 + case .foregroundInactive: return 2 + case .background: return 3 + case .unattached: return 4 + @unknown default: return 5 + } + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/Weak.swift b/Demo/Pods/SwiftMessages/SwiftMessages/Weak.swift new file mode 100644 index 0000000..a9bc470 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/Weak.swift @@ -0,0 +1,16 @@ +// +// Weak.swift +// SwiftMessages +// +// Created by Timothy Moose on 6/4/17. +// Copyright © 2017 SwiftKick Mobile. All rights reserved. +// + +import Foundation + +public class Weak { + public weak var value : T? + public init(value: T?) { + self.value = value + } +} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/WindowScene.swift b/Demo/Pods/SwiftMessages/SwiftMessages/WindowScene.swift new file mode 100644 index 0000000..a3bbb4c --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/WindowScene.swift @@ -0,0 +1,9 @@ +import Foundation +import UIKit + +/// A workaround for the change in Xcode 13 that prevents using `@availability` attribute +/// with `enum` cases containing associated values. +public protocol WindowScene {} + +@available(iOS 13.0, *) +extension UIWindowScene: WindowScene {} diff --git a/Demo/Pods/SwiftMessages/SwiftMessages/WindowViewController.swift b/Demo/Pods/SwiftMessages/SwiftMessages/WindowViewController.swift new file mode 100644 index 0000000..9c2b721 --- /dev/null +++ b/Demo/Pods/SwiftMessages/SwiftMessages/WindowViewController.swift @@ -0,0 +1,95 @@ +// +// WindowViewController.swift +// SwiftMessages +// +// Created by Timothy Moose on 8/1/16. +// Copyright © 2016 SwiftKick Mobile LLC. All rights reserved. +// + +import UIKit + +open class WindowViewController: UIViewController +{ + override open var shouldAutorotate: Bool { + return config.shouldAutorotate + } + + convenience public init() { + self.init(config: SwiftMessages.Config()) + } + + public init(config: SwiftMessages.Config) { + self.config = config + let view = PassthroughView() + let window = PassthroughWindow(hitTestView: view) + self.window = window + super.init(nibName: nil, bundle: nil) + self.view = view + window.rootViewController = self + window.windowLevel = config.windowLevel ?? UIWindow.Level.normal + if #available(iOS 13, *) { + window.overrideUserInterfaceStyle = config.overrideUserInterfaceStyle + } + } + + func install() { + if #available(iOS 13, *) { + window?.windowScene = config.windowScene + #if !SWIFTMESSAGES_APP_EXTENSIONS + previousKeyWindow = UIWindow.keyWindow + #endif + show( + becomeKey: config.shouldBecomeKeyWindow, + frame: config.windowScene?.coordinateSpace.bounds + ) + } else { + show(becomeKey: config.shouldBecomeKeyWindow) + } + } + + private func show(becomeKey: Bool, frame: CGRect? = nil) { + guard let window = window else { return } + window.frame = frame ?? UIScreen.main.bounds + if becomeKey { + window.makeKeyAndVisible() + } else { + window.isHidden = false + } + } + + func uninstall() { + if window?.isKeyWindow == true { + previousKeyWindow?.makeKey() + } + if #available(iOS 13, *) { + window?.windowScene = nil + } + window?.isHidden = true + window = nil + } + + required public init?(coder aDecoder: NSCoder) { + fatalError("init(coder:) has not been implemented") + } + + override open var preferredStatusBarStyle: UIStatusBarStyle { + return config.preferredStatusBarStyle ?? super.preferredStatusBarStyle + } + + open override var prefersStatusBarHidden: Bool { + return config.prefersStatusBarHidden ?? super.prefersStatusBarHidden + } + + // MARK: - Variables + + private var window: UIWindow? + private weak var previousKeyWindow: UIWindow? + + let config: SwiftMessages.Config +} + +extension WindowViewController { + static func newInstance(config: SwiftMessages.Config) -> WindowViewController { + return config.windowViewController?(config) ?? WindowViewController(config: config) + } +} diff --git a/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-Info.plist b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-Info.plist new file mode 100644 index 0000000..fee5e01 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-Info.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + ${PODS_DEVELOPMENT_LANGUAGE} + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + ${PRODUCT_NAME} + CFBundlePackageType + FMWK + CFBundleShortVersionString + 4.0.0 + CFBundleSignature + ???? + CFBundleVersion + ${CURRENT_PROJECT_VERSION} + NSPrincipalClass + + + diff --git a/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-dummy.m b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-dummy.m new file mode 100644 index 0000000..1780c1c --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-dummy.m @@ -0,0 +1,5 @@ +#import +@interface PodsDummy_IGListDiffKit : NSObject +@end +@implementation PodsDummy_IGListDiffKit +@end diff --git a/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-prefix.pch b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-prefix.pch new file mode 100644 index 0000000..beb2a24 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-prefix.pch @@ -0,0 +1,12 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + diff --git a/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-umbrella.h b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-umbrella.h new file mode 100644 index 0000000..beba78c --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit-umbrella.h @@ -0,0 +1,30 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + +#import "IGListAssert.h" +#import "IGListBatchUpdateData.h" +#import "IGListCompatibility.h" +#import "IGListDiff.h" +#import "IGListDiffable.h" +#import "IGListDiffKit.h" +#import "IGListExperiments.h" +#import "IGListIndexPathResult.h" +#import "IGListIndexSetResult.h" +#import "IGListMacros.h" +#import "IGListMoveIndex.h" +#import "IGListMoveIndexPath.h" +#import "NSNumber+IGListDiffable.h" +#import "NSString+IGListDiffable.h" + +FOUNDATION_EXPORT double IGListDiffKitVersionNumber; +FOUNDATION_EXPORT const unsigned char IGListDiffKitVersionString[]; + diff --git a/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.debug.xcconfig b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.debug.xcconfig new file mode 100644 index 0000000..c8f56e1 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.debug.xcconfig @@ -0,0 +1,15 @@ +CLANG_CXX_LANGUAGE_STANDARD = c++11 +CLANG_CXX_LIBRARY = libc++ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +OTHER_LDFLAGS = $(inherited) -l"c++" -framework "UIKit" +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/IGListDiffKit +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.modulemap b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.modulemap new file mode 100644 index 0000000..24eddd1 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.modulemap @@ -0,0 +1,6 @@ +framework module IGListDiffKit { + umbrella header "IGListDiffKit-umbrella.h" + + export * + module * { export * } +} diff --git a/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.release.xcconfig b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.release.xcconfig new file mode 100644 index 0000000..c8f56e1 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListDiffKit/IGListDiffKit.release.xcconfig @@ -0,0 +1,15 @@ +CLANG_CXX_LANGUAGE_STANDARD = c++11 +CLANG_CXX_LIBRARY = libc++ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +OTHER_LDFLAGS = $(inherited) -l"c++" -framework "UIKit" +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/IGListDiffKit +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/IGListKit/IGListKit-Info.plist b/Demo/Pods/Target Support Files/IGListKit/IGListKit-Info.plist new file mode 100644 index 0000000..fee5e01 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListKit/IGListKit-Info.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + ${PODS_DEVELOPMENT_LANGUAGE} + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + ${PRODUCT_NAME} + CFBundlePackageType + FMWK + CFBundleShortVersionString + 4.0.0 + CFBundleSignature + ???? + CFBundleVersion + ${CURRENT_PROJECT_VERSION} + NSPrincipalClass + + + diff --git a/Demo/Pods/Target Support Files/IGListKit/IGListKit-dummy.m b/Demo/Pods/Target Support Files/IGListKit/IGListKit-dummy.m new file mode 100644 index 0000000..50cf882 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListKit/IGListKit-dummy.m @@ -0,0 +1,5 @@ +#import +@interface PodsDummy_IGListKit : NSObject +@end +@implementation PodsDummy_IGListKit +@end diff --git a/Demo/Pods/Target Support Files/IGListKit/IGListKit-prefix.pch b/Demo/Pods/Target Support Files/IGListKit/IGListKit-prefix.pch new file mode 100644 index 0000000..beb2a24 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListKit/IGListKit-prefix.pch @@ -0,0 +1,12 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + diff --git a/Demo/Pods/Target Support Files/IGListKit/IGListKit-umbrella.h b/Demo/Pods/Target Support Files/IGListKit/IGListKit-umbrella.h new file mode 100644 index 0000000..bef36ee --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListKit/IGListKit-umbrella.h @@ -0,0 +1,46 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + +#import "IGListAdapter.h" +#import "IGListAdapterDataSource.h" +#import "IGListAdapterDelegate.h" +#import "IGListAdapterMoveDelegate.h" +#import "IGListAdapterPerformanceDelegate.h" +#import "IGListAdapterUpdateListener.h" +#import "IGListAdapterUpdater.h" +#import "IGListAdapterUpdaterDelegate.h" +#import "IGListBatchContext.h" +#import "IGListBindable.h" +#import "IGListBindingSectionController.h" +#import "IGListBindingSectionControllerDataSource.h" +#import "IGListBindingSectionControllerSelectionDelegate.h" +#import "IGListCollectionContext.h" +#import "IGListCollectionScrollingTraits.h" +#import "IGListCollectionView.h" +#import "IGListCollectionViewDelegateLayout.h" +#import "IGListCollectionViewLayout.h" +#import "IGListCollectionViewLayoutCompatible.h" +#import "IGListDisplayDelegate.h" +#import "IGListGenericSectionController.h" +#import "IGListKit.h" +#import "IGListReloadDataUpdater.h" +#import "IGListScrollDelegate.h" +#import "IGListSectionController.h" +#import "IGListSingleSectionController.h" +#import "IGListSupplementaryViewSource.h" +#import "IGListTransitionDelegate.h" +#import "IGListUpdatingDelegate.h" +#import "IGListWorkingRangeDelegate.h" + +FOUNDATION_EXPORT double IGListKitVersionNumber; +FOUNDATION_EXPORT const unsigned char IGListKitVersionString[]; + diff --git a/Demo/Pods/Target Support Files/IGListKit/IGListKit.debug.xcconfig b/Demo/Pods/Target Support Files/IGListKit/IGListKit.debug.xcconfig new file mode 100644 index 0000000..af17724 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListKit/IGListKit.debug.xcconfig @@ -0,0 +1,16 @@ +CLANG_CXX_LANGUAGE_STANDARD = c++11 +CLANG_CXX_LIBRARY = libc++ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/IGListKit +FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit" +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +OTHER_LDFLAGS = $(inherited) -l"c++" -framework "IGListDiffKit" -framework "UIKit" +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/IGListKit +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/IGListKit/IGListKit.modulemap b/Demo/Pods/Target Support Files/IGListKit/IGListKit.modulemap new file mode 100644 index 0000000..76fc8f0 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListKit/IGListKit.modulemap @@ -0,0 +1,6 @@ +framework module IGListKit { + umbrella header "IGListKit-umbrella.h" + + export * + module * { export * } +} diff --git a/Demo/Pods/Target Support Files/IGListKit/IGListKit.release.xcconfig b/Demo/Pods/Target Support Files/IGListKit/IGListKit.release.xcconfig new file mode 100644 index 0000000..af17724 --- /dev/null +++ b/Demo/Pods/Target Support Files/IGListKit/IGListKit.release.xcconfig @@ -0,0 +1,16 @@ +CLANG_CXX_LANGUAGE_STANDARD = c++11 +CLANG_CXX_LIBRARY = libc++ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/IGListKit +FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit" +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +OTHER_LDFLAGS = $(inherited) -l"c++" -framework "IGListDiffKit" -framework "UIKit" +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/IGListKit +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-Info.plist b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-Info.plist new file mode 100644 index 0000000..119cb52 --- /dev/null +++ b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-Info.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + ${PODS_DEVELOPMENT_LANGUAGE} + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + ${PRODUCT_NAME} + CFBundlePackageType + FMWK + CFBundleShortVersionString + 7.6.2 + CFBundleSignature + ???? + CFBundleVersion + ${CURRENT_PROJECT_VERSION} + NSPrincipalClass + + + diff --git a/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-dummy.m b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-dummy.m new file mode 100644 index 0000000..1b89d0e --- /dev/null +++ b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-dummy.m @@ -0,0 +1,5 @@ +#import +@interface PodsDummy_Kingfisher : NSObject +@end +@implementation PodsDummy_Kingfisher +@end diff --git a/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-prefix.pch b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-prefix.pch new file mode 100644 index 0000000..beb2a24 --- /dev/null +++ b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-prefix.pch @@ -0,0 +1,12 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + diff --git a/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-umbrella.h b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-umbrella.h new file mode 100644 index 0000000..75a7996 --- /dev/null +++ b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher-umbrella.h @@ -0,0 +1,16 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + + +FOUNDATION_EXPORT double KingfisherVersionNumber; +FOUNDATION_EXPORT const unsigned char KingfisherVersionString[]; + diff --git a/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.debug.xcconfig b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.debug.xcconfig new file mode 100644 index 0000000..849f1e9 --- /dev/null +++ b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.debug.xcconfig @@ -0,0 +1,15 @@ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/Kingfisher +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -framework "Accelerate" -framework "CFNetwork" -weak_framework "Combine" -weak_framework "SwiftUI" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/Kingfisher +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.modulemap b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.modulemap new file mode 100644 index 0000000..2a20d91 --- /dev/null +++ b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.modulemap @@ -0,0 +1,6 @@ +framework module Kingfisher { + umbrella header "Kingfisher-umbrella.h" + + export * + module * { export * } +} diff --git a/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.release.xcconfig b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.release.xcconfig new file mode 100644 index 0000000..849f1e9 --- /dev/null +++ b/Demo/Pods/Target Support Files/Kingfisher/Kingfisher.release.xcconfig @@ -0,0 +1,15 @@ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/Kingfisher +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -framework "Accelerate" -framework "CFNetwork" -weak_framework "Combine" -weak_framework "SwiftUI" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/Kingfisher +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-Info.plist b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-Info.plist new file mode 100644 index 0000000..19cf209 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-Info.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + ${PODS_DEVELOPMENT_LANGUAGE} + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + ${PRODUCT_NAME} + CFBundlePackageType + FMWK + CFBundleShortVersionString + 1.0.0 + CFBundleSignature + ???? + CFBundleVersion + ${CURRENT_PROJECT_VERSION} + NSPrincipalClass + + + diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-acknowledgements.markdown b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-acknowledgements.markdown new file mode 100644 index 0000000..02ff2fc --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-acknowledgements.markdown @@ -0,0 +1,112 @@ +# Acknowledgements +This application makes use of the following third party libraries: + +## IGListDiffKit + +MIT License + +Copyright (c) Facebook, Inc. and its affiliates. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +## IGListKit + +MIT License + +Copyright (c) Facebook, Inc. and its affiliates. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +## Kingfisher + +The MIT License (MIT) + +Copyright (c) 2019 Wei Wang + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + + + +## SwiftMessages + +Copyright (c) 2016 SwiftKick Mobile LLC + + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +## UIColor_Hex_Swift + +The MIT License (MIT) + +Copyright (c) 2014 R0CKSTAR + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. +Generated by CocoaPods - https://cocoapods.org diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-acknowledgements.plist b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-acknowledgements.plist new file mode 100644 index 0000000..ca35106 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-acknowledgements.plist @@ -0,0 +1,168 @@ + + + + + PreferenceSpecifiers + + + FooterText + This application makes use of the following third party libraries: + Title + Acknowledgements + Type + PSGroupSpecifier + + + FooterText + MIT License + +Copyright (c) Facebook, Inc. and its affiliates. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + License + MIT + Title + IGListDiffKit + Type + PSGroupSpecifier + + + FooterText + MIT License + +Copyright (c) Facebook, Inc. and its affiliates. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + License + MIT + Title + IGListKit + Type + PSGroupSpecifier + + + FooterText + The MIT License (MIT) + +Copyright (c) 2019 Wei Wang + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + + + License + MIT + Title + Kingfisher + Type + PSGroupSpecifier + + + FooterText + Copyright (c) 2016 SwiftKick Mobile LLC + + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + License + MIT + Title + SwiftMessages + Type + PSGroupSpecifier + + + FooterText + The MIT License (MIT) + +Copyright (c) 2014 R0CKSTAR + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + License + MIT + Title + UIColor_Hex_Swift + Type + PSGroupSpecifier + + + FooterText + Generated by CocoaPods - https://cocoapods.org + Title + + Type + PSGroupSpecifier + + + StringsTable + Acknowledgements + Title + Acknowledgements + + diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-dummy.m b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-dummy.m new file mode 100644 index 0000000..d0fcb93 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-dummy.m @@ -0,0 +1,5 @@ +#import +@interface PodsDummy_Pods_Bulletin : NSObject +@end +@implementation PodsDummy_Pods_Bulletin +@end diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Debug-input-files.xcfilelist b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Debug-input-files.xcfilelist new file mode 100644 index 0000000..f7ae177 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Debug-input-files.xcfilelist @@ -0,0 +1,6 @@ +${PODS_ROOT}/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks.sh +${BUILT_PRODUCTS_DIR}/IGListDiffKit/IGListDiffKit.framework +${BUILT_PRODUCTS_DIR}/IGListKit/IGListKit.framework +${BUILT_PRODUCTS_DIR}/Kingfisher/Kingfisher.framework +${BUILT_PRODUCTS_DIR}/SwiftMessages/SwiftMessages.framework +${BUILT_PRODUCTS_DIR}/UIColor_Hex_Swift/UIColor_Hex_Swift.framework \ No newline at end of file diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Debug-output-files.xcfilelist b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Debug-output-files.xcfilelist new file mode 100644 index 0000000..644b818 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Debug-output-files.xcfilelist @@ -0,0 +1,5 @@ +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/IGListDiffKit.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/IGListKit.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/Kingfisher.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/SwiftMessages.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/UIColor_Hex_Swift.framework \ No newline at end of file diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Release-input-files.xcfilelist b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Release-input-files.xcfilelist new file mode 100644 index 0000000..f7ae177 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Release-input-files.xcfilelist @@ -0,0 +1,6 @@ +${PODS_ROOT}/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks.sh +${BUILT_PRODUCTS_DIR}/IGListDiffKit/IGListDiffKit.framework +${BUILT_PRODUCTS_DIR}/IGListKit/IGListKit.framework +${BUILT_PRODUCTS_DIR}/Kingfisher/Kingfisher.framework +${BUILT_PRODUCTS_DIR}/SwiftMessages/SwiftMessages.framework +${BUILT_PRODUCTS_DIR}/UIColor_Hex_Swift/UIColor_Hex_Swift.framework \ No newline at end of file diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Release-output-files.xcfilelist b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Release-output-files.xcfilelist new file mode 100644 index 0000000..644b818 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks-Release-output-files.xcfilelist @@ -0,0 +1,5 @@ +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/IGListDiffKit.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/IGListKit.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/Kingfisher.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/SwiftMessages.framework +${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/UIColor_Hex_Swift.framework \ No newline at end of file diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks.sh b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks.sh new file mode 100755 index 0000000..c399c7b --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-frameworks.sh @@ -0,0 +1,194 @@ +#!/bin/sh +set -e +set -u +set -o pipefail + +function on_error { + echo "$(realpath -mq "${0}"):$1: error: Unexpected failure" +} +trap 'on_error $LINENO' ERR + +if [ -z ${FRAMEWORKS_FOLDER_PATH+x} ]; then + # If FRAMEWORKS_FOLDER_PATH is not set, then there's nowhere for us to copy + # frameworks to, so exit 0 (signalling the script phase was successful). + exit 0 +fi + +echo "mkdir -p ${CONFIGURATION_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}" +mkdir -p "${CONFIGURATION_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}" + +COCOAPODS_PARALLEL_CODE_SIGN="${COCOAPODS_PARALLEL_CODE_SIGN:-false}" +SWIFT_STDLIB_PATH="${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" +BCSYMBOLMAP_DIR="BCSymbolMaps" + + +# This protects against multiple targets copying the same framework dependency at the same time. The solution +# was originally proposed here: https://lists.samba.org/archive/rsync/2008-February/020158.html +RSYNC_PROTECT_TMP_FILES=(--filter "P .*.??????") + +# Copies and strips a vendored framework +install_framework() +{ + if [ -r "${BUILT_PRODUCTS_DIR}/$1" ]; then + local source="${BUILT_PRODUCTS_DIR}/$1" + elif [ -r "${BUILT_PRODUCTS_DIR}/$(basename "$1")" ]; then + local source="${BUILT_PRODUCTS_DIR}/$(basename "$1")" + elif [ -r "$1" ]; then + local source="$1" + fi + + local destination="${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}" + + if [ -L "${source}" ]; then + echo "Symlinked..." + source="$(readlink -f "${source}")" + fi + + if [ -d "${source}/${BCSYMBOLMAP_DIR}" ]; then + # Locate and install any .bcsymbolmaps if present, and remove them from the .framework before the framework is copied + find "${source}/${BCSYMBOLMAP_DIR}" -name "*.bcsymbolmap"|while read f; do + echo "Installing $f" + install_bcsymbolmap "$f" "$destination" + rm "$f" + done + rmdir "${source}/${BCSYMBOLMAP_DIR}" + fi + + # Use filter instead of exclude so missing patterns don't throw errors. + echo "rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter \"- CVS/\" --filter \"- .svn/\" --filter \"- .git/\" --filter \"- .hg/\" --filter \"- Headers\" --filter \"- PrivateHeaders\" --filter \"- Modules\" \"${source}\" \"${destination}\"" + rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" --filter "- Headers" --filter "- PrivateHeaders" --filter "- Modules" "${source}" "${destination}" + + local basename + basename="$(basename -s .framework "$1")" + binary="${destination}/${basename}.framework/${basename}" + + if ! [ -r "$binary" ]; then + binary="${destination}/${basename}" + elif [ -L "${binary}" ]; then + echo "Destination binary is symlinked..." + dirname="$(dirname "${binary}")" + binary="${dirname}/$(readlink "${binary}")" + fi + + # Strip invalid architectures so "fat" simulator / device frameworks work on device + if [[ "$(file "$binary")" == *"dynamically linked shared library"* ]]; then + strip_invalid_archs "$binary" + fi + + # Resign the code if required by the build settings to avoid unstable apps + code_sign_if_enabled "${destination}/$(basename "$1")" + + # Embed linked Swift runtime libraries. No longer necessary as of Xcode 7. + if [ "${XCODE_VERSION_MAJOR}" -lt 7 ]; then + local swift_runtime_libs + swift_runtime_libs=$(xcrun otool -LX "$binary" | grep --color=never @rpath/libswift | sed -E s/@rpath\\/\(.+dylib\).*/\\1/g | uniq -u) + for lib in $swift_runtime_libs; do + echo "rsync -auv \"${SWIFT_STDLIB_PATH}/${lib}\" \"${destination}\"" + rsync -auv "${SWIFT_STDLIB_PATH}/${lib}" "${destination}" + code_sign_if_enabled "${destination}/${lib}" + done + fi +} +# Copies and strips a vendored dSYM +install_dsym() { + local source="$1" + warn_missing_arch=${2:-true} + if [ -r "$source" ]; then + # Copy the dSYM into the targets temp dir. + echo "rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --filter \"- CVS/\" --filter \"- .svn/\" --filter \"- .git/\" --filter \"- .hg/\" --filter \"- Headers\" --filter \"- PrivateHeaders\" --filter \"- Modules\" \"${source}\" \"${DERIVED_FILES_DIR}\"" + rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" --filter "- Headers" --filter "- PrivateHeaders" --filter "- Modules" "${source}" "${DERIVED_FILES_DIR}" + + local basename + basename="$(basename -s .dSYM "$source")" + binary_name="$(ls "$source/Contents/Resources/DWARF")" + binary="${DERIVED_FILES_DIR}/${basename}.dSYM/Contents/Resources/DWARF/${binary_name}" + + # Strip invalid architectures from the dSYM. + if [[ "$(file "$binary")" == *"Mach-O "*"dSYM companion"* ]]; then + strip_invalid_archs "$binary" "$warn_missing_arch" + fi + if [[ $STRIP_BINARY_RETVAL == 0 ]]; then + # Move the stripped file into its final destination. + echo "rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter \"- CVS/\" --filter \"- .svn/\" --filter \"- .git/\" --filter \"- .hg/\" --filter \"- Headers\" --filter \"- PrivateHeaders\" --filter \"- Modules\" \"${DERIVED_FILES_DIR}/${basename}.framework.dSYM\" \"${DWARF_DSYM_FOLDER_PATH}\"" + rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --links --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" --filter "- Headers" --filter "- PrivateHeaders" --filter "- Modules" "${DERIVED_FILES_DIR}/${basename}.dSYM" "${DWARF_DSYM_FOLDER_PATH}" + else + # The dSYM was not stripped at all, in this case touch a fake folder so the input/output paths from Xcode do not reexecute this script because the file is missing. + mkdir -p "${DWARF_DSYM_FOLDER_PATH}" + touch "${DWARF_DSYM_FOLDER_PATH}/${basename}.dSYM" + fi + fi +} + +# Used as a return value for each invocation of `strip_invalid_archs` function. +STRIP_BINARY_RETVAL=0 + +# Strip invalid architectures +strip_invalid_archs() { + binary="$1" + warn_missing_arch=${2:-true} + # Get architectures for current target binary + binary_archs="$(lipo -info "$binary" | rev | cut -d ':' -f1 | awk '{$1=$1;print}' | rev)" + # Intersect them with the architectures we are building for + intersected_archs="$(echo ${ARCHS[@]} ${binary_archs[@]} | tr ' ' '\n' | sort | uniq -d)" + # If there are no archs supported by this binary then warn the user + if [[ -z "$intersected_archs" ]]; then + if [[ "$warn_missing_arch" == "true" ]]; then + echo "warning: [CP] Vendored binary '$binary' contains architectures ($binary_archs) none of which match the current build architectures ($ARCHS)." + fi + STRIP_BINARY_RETVAL=1 + return + fi + stripped="" + for arch in $binary_archs; do + if ! [[ "${ARCHS}" == *"$arch"* ]]; then + # Strip non-valid architectures in-place + lipo -remove "$arch" -output "$binary" "$binary" + stripped="$stripped $arch" + fi + done + if [[ "$stripped" ]]; then + echo "Stripped $binary of architectures:$stripped" + fi + STRIP_BINARY_RETVAL=0 +} + +# Copies the bcsymbolmap files of a vendored framework +install_bcsymbolmap() { + local bcsymbolmap_path="$1" + local destination="${BUILT_PRODUCTS_DIR}" + echo "rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" --filter "- Headers" --filter "- PrivateHeaders" --filter "- Modules" "${bcsymbolmap_path}" "${destination}"" + rsync --delete -av "${RSYNC_PROTECT_TMP_FILES[@]}" --filter "- CVS/" --filter "- .svn/" --filter "- .git/" --filter "- .hg/" --filter "- Headers" --filter "- PrivateHeaders" --filter "- Modules" "${bcsymbolmap_path}" "${destination}" +} + +# Signs a framework with the provided identity +code_sign_if_enabled() { + if [ -n "${EXPANDED_CODE_SIGN_IDENTITY:-}" -a "${CODE_SIGNING_REQUIRED:-}" != "NO" -a "${CODE_SIGNING_ALLOWED}" != "NO" ]; then + # Use the current code_sign_identity + echo "Code Signing $1 with Identity ${EXPANDED_CODE_SIGN_IDENTITY_NAME}" + local code_sign_cmd="/usr/bin/codesign --force --sign ${EXPANDED_CODE_SIGN_IDENTITY} ${OTHER_CODE_SIGN_FLAGS:-} --preserve-metadata=identifier,entitlements '$1'" + + if [ "${COCOAPODS_PARALLEL_CODE_SIGN}" == "true" ]; then + code_sign_cmd="$code_sign_cmd &" + fi + echo "$code_sign_cmd" + eval "$code_sign_cmd" + fi +} + +if [[ "$CONFIGURATION" == "Debug" ]]; then + install_framework "${BUILT_PRODUCTS_DIR}/IGListDiffKit/IGListDiffKit.framework" + install_framework "${BUILT_PRODUCTS_DIR}/IGListKit/IGListKit.framework" + install_framework "${BUILT_PRODUCTS_DIR}/Kingfisher/Kingfisher.framework" + install_framework "${BUILT_PRODUCTS_DIR}/SwiftMessages/SwiftMessages.framework" + install_framework "${BUILT_PRODUCTS_DIR}/UIColor_Hex_Swift/UIColor_Hex_Swift.framework" +fi +if [[ "$CONFIGURATION" == "Release" ]]; then + install_framework "${BUILT_PRODUCTS_DIR}/IGListDiffKit/IGListDiffKit.framework" + install_framework "${BUILT_PRODUCTS_DIR}/IGListKit/IGListKit.framework" + install_framework "${BUILT_PRODUCTS_DIR}/Kingfisher/Kingfisher.framework" + install_framework "${BUILT_PRODUCTS_DIR}/SwiftMessages/SwiftMessages.framework" + install_framework "${BUILT_PRODUCTS_DIR}/UIColor_Hex_Swift/UIColor_Hex_Swift.framework" +fi +if [ "${COCOAPODS_PARALLEL_CODE_SIGN}" == "true" ]; then + wait +fi diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-umbrella.h b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-umbrella.h new file mode 100644 index 0000000..3494f0c --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin-umbrella.h @@ -0,0 +1,16 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + + +FOUNDATION_EXPORT double Pods_BulletinVersionNumber; +FOUNDATION_EXPORT const unsigned char Pods_BulletinVersionString[]; + diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.debug.xcconfig b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.debug.xcconfig new file mode 100644 index 0000000..f59b86d --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.debug.xcconfig @@ -0,0 +1,15 @@ +ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit" "${PODS_CONFIGURATION_BUILD_DIR}/IGListKit" "${PODS_CONFIGURATION_BUILD_DIR}/Kingfisher" "${PODS_CONFIGURATION_BUILD_DIR}/SwiftMessages" "${PODS_CONFIGURATION_BUILD_DIR}/UIColor_Hex_Swift" +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +HEADER_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit/IGListDiffKit.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/IGListKit/IGListKit.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/Kingfisher/Kingfisher.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/SwiftMessages/SwiftMessages.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/UIColor_Hex_Swift/UIColor_Hex_Swift.framework/Headers" +LD_RUNPATH_SEARCH_PATHS = $(inherited) /usr/lib/swift '@executable_path/Frameworks' '@loader_path/Frameworks' +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -l"c++" -framework "Accelerate" -framework "CFNetwork" -framework "IGListDiffKit" -framework "IGListKit" -framework "Kingfisher" -framework "SwiftMessages" -framework "UIColor_Hex_Swift" -framework "UIKit" -weak_framework "Combine" -weak_framework "SwiftUI" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_PODFILE_DIR_PATH = ${SRCROOT}/. +PODS_ROOT = ${SRCROOT}/Pods +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.modulemap b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.modulemap new file mode 100644 index 0000000..2a95ea7 --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.modulemap @@ -0,0 +1,6 @@ +framework module Pods_Bulletin { + umbrella header "Pods-Bulletin-umbrella.h" + + export * + module * { export * } +} diff --git a/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.release.xcconfig b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.release.xcconfig new file mode 100644 index 0000000..f59b86d --- /dev/null +++ b/Demo/Pods/Target Support Files/Pods-Bulletin/Pods-Bulletin.release.xcconfig @@ -0,0 +1,15 @@ +ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES = YES +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +FRAMEWORK_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit" "${PODS_CONFIGURATION_BUILD_DIR}/IGListKit" "${PODS_CONFIGURATION_BUILD_DIR}/Kingfisher" "${PODS_CONFIGURATION_BUILD_DIR}/SwiftMessages" "${PODS_CONFIGURATION_BUILD_DIR}/UIColor_Hex_Swift" +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +HEADER_SEARCH_PATHS = $(inherited) "${PODS_CONFIGURATION_BUILD_DIR}/IGListDiffKit/IGListDiffKit.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/IGListKit/IGListKit.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/Kingfisher/Kingfisher.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/SwiftMessages/SwiftMessages.framework/Headers" "${PODS_CONFIGURATION_BUILD_DIR}/UIColor_Hex_Swift/UIColor_Hex_Swift.framework/Headers" +LD_RUNPATH_SEARCH_PATHS = $(inherited) /usr/lib/swift '@executable_path/Frameworks' '@loader_path/Frameworks' +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -l"c++" -framework "Accelerate" -framework "CFNetwork" -framework "IGListDiffKit" -framework "IGListKit" -framework "Kingfisher" -framework "SwiftMessages" -framework "UIColor_Hex_Swift" -framework "UIKit" -weak_framework "Combine" -weak_framework "SwiftUI" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_PODFILE_DIR_PATH = ${SRCROOT}/. +PODS_ROOT = ${SRCROOT}/Pods +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/SwiftMessages/ResourceBundle-SwiftMessages-SwiftMessages-Info.plist b/Demo/Pods/Target Support Files/SwiftMessages/ResourceBundle-SwiftMessages-SwiftMessages-Info.plist new file mode 100644 index 0000000..e0f20fc --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/ResourceBundle-SwiftMessages-SwiftMessages-Info.plist @@ -0,0 +1,24 @@ + + + + + CFBundleDevelopmentRegion + ${PODS_DEVELOPMENT_LANGUAGE} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + ${PRODUCT_NAME} + CFBundlePackageType + BNDL + CFBundleShortVersionString + 9.0.6 + CFBundleSignature + ???? + CFBundleVersion + 1 + NSPrincipalClass + + + diff --git a/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-Info.plist b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-Info.plist new file mode 100644 index 0000000..ec23eec --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-Info.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + ${PODS_DEVELOPMENT_LANGUAGE} + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + ${PRODUCT_NAME} + CFBundlePackageType + FMWK + CFBundleShortVersionString + 9.0.6 + CFBundleSignature + ???? + CFBundleVersion + ${CURRENT_PROJECT_VERSION} + NSPrincipalClass + + + diff --git a/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-dummy.m b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-dummy.m new file mode 100644 index 0000000..dc460b8 --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-dummy.m @@ -0,0 +1,5 @@ +#import +@interface PodsDummy_SwiftMessages : NSObject +@end +@implementation PodsDummy_SwiftMessages +@end diff --git a/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-prefix.pch b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-prefix.pch new file mode 100644 index 0000000..beb2a24 --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-prefix.pch @@ -0,0 +1,12 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + diff --git a/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-umbrella.h b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-umbrella.h new file mode 100644 index 0000000..9aa634f --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages-umbrella.h @@ -0,0 +1,16 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + + +FOUNDATION_EXPORT double SwiftMessagesVersionNumber; +FOUNDATION_EXPORT const unsigned char SwiftMessagesVersionString[]; + diff --git a/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.debug.xcconfig b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.debug.xcconfig new file mode 100644 index 0000000..7359800 --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.debug.xcconfig @@ -0,0 +1,15 @@ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/SwiftMessages +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -framework "UIKit" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/SwiftMessages +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.modulemap b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.modulemap new file mode 100644 index 0000000..96306d6 --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.modulemap @@ -0,0 +1,6 @@ +framework module SwiftMessages { + umbrella header "SwiftMessages-umbrella.h" + + export * + module * { export * } +} diff --git a/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.release.xcconfig b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.release.xcconfig new file mode 100644 index 0000000..7359800 --- /dev/null +++ b/Demo/Pods/Target Support Files/SwiftMessages/SwiftMessages.release.xcconfig @@ -0,0 +1,15 @@ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/SwiftMessages +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -framework "UIKit" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/SwiftMessages +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-Info.plist b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-Info.plist new file mode 100644 index 0000000..b5c956c --- /dev/null +++ b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-Info.plist @@ -0,0 +1,26 @@ + + + + + CFBundleDevelopmentRegion + ${PODS_DEVELOPMENT_LANGUAGE} + CFBundleExecutable + ${EXECUTABLE_NAME} + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleInfoDictionaryVersion + 6.0 + CFBundleName + ${PRODUCT_NAME} + CFBundlePackageType + FMWK + CFBundleShortVersionString + 5.1.7 + CFBundleSignature + ???? + CFBundleVersion + ${CURRENT_PROJECT_VERSION} + NSPrincipalClass + + + diff --git a/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-dummy.m b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-dummy.m new file mode 100644 index 0000000..fb34f15 --- /dev/null +++ b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-dummy.m @@ -0,0 +1,5 @@ +#import +@interface PodsDummy_UIColor_Hex_Swift : NSObject +@end +@implementation PodsDummy_UIColor_Hex_Swift +@end diff --git a/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-prefix.pch b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-prefix.pch new file mode 100644 index 0000000..beb2a24 --- /dev/null +++ b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-prefix.pch @@ -0,0 +1,12 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + diff --git a/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-umbrella.h b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-umbrella.h new file mode 100644 index 0000000..d463f41 --- /dev/null +++ b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift-umbrella.h @@ -0,0 +1,17 @@ +#ifdef __OBJC__ +#import +#else +#ifndef FOUNDATION_EXPORT +#if defined(__cplusplus) +#define FOUNDATION_EXPORT extern "C" +#else +#define FOUNDATION_EXPORT extern +#endif +#endif +#endif + +#import "HEXColor.h" + +FOUNDATION_EXPORT double UIColor_Hex_SwiftVersionNumber; +FOUNDATION_EXPORT const unsigned char UIColor_Hex_SwiftVersionString[]; + diff --git a/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.debug.xcconfig b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.debug.xcconfig new file mode 100644 index 0000000..b0259dd --- /dev/null +++ b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.debug.xcconfig @@ -0,0 +1,15 @@ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/UIColor_Hex_Swift +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -framework "UIKit" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/UIColor_Hex_Swift +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.modulemap b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.modulemap new file mode 100644 index 0000000..bc61251 --- /dev/null +++ b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.modulemap @@ -0,0 +1,6 @@ +framework module UIColor_Hex_Swift { + umbrella header "UIColor_Hex_Swift-umbrella.h" + + export * + module * { export * } +} diff --git a/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.release.xcconfig b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.release.xcconfig new file mode 100644 index 0000000..b0259dd --- /dev/null +++ b/Demo/Pods/Target Support Files/UIColor_Hex_Swift/UIColor_Hex_Swift.release.xcconfig @@ -0,0 +1,15 @@ +CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = NO +CONFIGURATION_BUILD_DIR = ${PODS_CONFIGURATION_BUILD_DIR}/UIColor_Hex_Swift +GCC_PREPROCESSOR_DEFINITIONS = $(inherited) COCOAPODS=1 +LIBRARY_SEARCH_PATHS = $(inherited) "${DT_TOOLCHAIN_DIR}/usr/lib/swift/${PLATFORM_NAME}" /usr/lib/swift +OTHER_LDFLAGS = $(inherited) -framework "UIKit" +OTHER_SWIFT_FLAGS = $(inherited) -D COCOAPODS +PODS_BUILD_DIR = ${BUILD_DIR} +PODS_CONFIGURATION_BUILD_DIR = ${PODS_BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) +PODS_DEVELOPMENT_LANGUAGE = ${DEVELOPMENT_LANGUAGE} +PODS_ROOT = ${SRCROOT} +PODS_TARGET_SRCROOT = ${PODS_ROOT}/UIColor_Hex_Swift +PODS_XCFRAMEWORKS_BUILD_DIR = $(PODS_CONFIGURATION_BUILD_DIR)/XCFrameworkIntermediates +PRODUCT_BUNDLE_IDENTIFIER = org.cocoapods.${PRODUCT_NAME:rfc1034identifier} +SKIP_INSTALL = YES +USE_RECURSIVE_SCRIPT_INPUTS_IN_SCRIPT_PHASES = YES diff --git a/Demo/Pods/UIColor_Hex_Swift/HEXColor/HEXColor.h b/Demo/Pods/UIColor_Hex_Swift/HEXColor/HEXColor.h new file mode 100644 index 0000000..7ad5a18 --- /dev/null +++ b/Demo/Pods/UIColor_Hex_Swift/HEXColor/HEXColor.h @@ -0,0 +1,17 @@ +// +// HEXColor.h +// HEXColor +// +// Created by Yuki Nagai on 10/5/15. +// Copyright © 2015 P.D.Q. All rights reserved. +// + +#import + +//! Project version number for HEXColor. +FOUNDATION_EXPORT double HEXColorVersionNumber; + +//! Project version string for HEXColor. +FOUNDATION_EXPORT const unsigned char HEXColorVersionString[]; + +// In this header, you should import all the public headers of your framework using statements like #import diff --git a/Demo/Pods/UIColor_Hex_Swift/HEXColor/StringExtension.swift b/Demo/Pods/UIColor_Hex_Swift/HEXColor/StringExtension.swift new file mode 100644 index 0000000..93eafe8 --- /dev/null +++ b/Demo/Pods/UIColor_Hex_Swift/HEXColor/StringExtension.swift @@ -0,0 +1,31 @@ +// +// StringExtension.swift +// HEXColor-iOS +// +// Created by Sergey Pugach on 2/2/18. +// Copyright © 2018 P.D.Q. All rights reserved. +// + +import Foundation + + +extension String { + /** + Convert argb string to rgba string. + */ + public var argb2rgba: String? { + guard self.hasPrefix("#") else { + return nil + } + + let hexString: String = String(self[self.index(self.startIndex, offsetBy: 1)...]) + switch hexString.count { + case 4: + return "#\(String(hexString[self.index(self.startIndex, offsetBy: 1)...]))\(String(hexString[..> 8) / divisor + let green = CGFloat((hex3 & 0x0F0) >> 4) / divisor + let blue = CGFloat( hex3 & 0x00F ) / divisor + self.init(red: red, green: green, blue: blue, alpha: alpha) + } + + /** + The shorthand four-digit hexadecimal representation of color with alpha. + #RGBA defines to the color #RRGGBBAA. + + - parameter hex4: Four-digit hexadecimal value. + */ + public convenience init(hex4: UInt16) { + let divisor = CGFloat(15) + let red = CGFloat((hex4 & 0xF000) >> 12) / divisor + let green = CGFloat((hex4 & 0x0F00) >> 8) / divisor + let blue = CGFloat((hex4 & 0x00F0) >> 4) / divisor + let alpha = CGFloat( hex4 & 0x000F ) / divisor + self.init(red: red, green: green, blue: blue, alpha: alpha) + } + + /** + The six-digit hexadecimal representation of color of the form #RRGGBB. + + - parameter hex6: Six-digit hexadecimal value. + */ + public convenience init(hex6: UInt32, alpha: CGFloat = 1) { + let divisor = CGFloat(255) + let red = CGFloat((hex6 & 0xFF0000) >> 16) / divisor + let green = CGFloat((hex6 & 0x00FF00) >> 8) / divisor + let blue = CGFloat( hex6 & 0x0000FF ) / divisor + self.init(red: red, green: green, blue: blue, alpha: alpha) + } + + /** + The six-digit hexadecimal representation of color with alpha of the form #RRGGBBAA. + + - parameter hex8: Eight-digit hexadecimal value. + */ + public convenience init(hex8: UInt32) { + let divisor = CGFloat(255) + let red = CGFloat((hex8 & 0xFF000000) >> 24) / divisor + let green = CGFloat((hex8 & 0x00FF0000) >> 16) / divisor + let blue = CGFloat((hex8 & 0x0000FF00) >> 8) / divisor + let alpha = CGFloat( hex8 & 0x000000FF ) / divisor + self.init(red: red, green: green, blue: blue, alpha: alpha) + } + + /** + The rgba string representation of color with alpha of the form #RRGGBBAA/#RRGGBB, throws error. + + - parameter rgba: String value. + */ + public convenience init(rgba_throws rgba: String) throws { + guard rgba.hasPrefix("#") else { + let error = UIColorInputError.missingHashMarkAsPrefix(rgba) + print(error.localizedDescription) + throw error + } + + let hexString: String = String(rgba[String.Index(utf16Offset: 1, in: rgba)...]) + var hexValue: UInt32 = 0 + + guard Scanner(string: hexString).scanHexInt32(&hexValue) else { + let error = UIColorInputError.unableToScanHexValue(rgba) + print(error.localizedDescription) + throw error + } + + switch (hexString.count) { + case 3: + self.init(hex3: UInt16(hexValue)) + case 4: + self.init(hex4: UInt16(hexValue)) + case 6: + self.init(hex6: hexValue) + case 8: + self.init(hex8: hexValue) + default: + let error = UIColorInputError.mismatchedHexStringLength(rgba) + print(error.localizedDescription) + throw error + } + } + + /** + The rgba string representation of color with alpha of the form #RRGGBBAA/#RRGGBB, fails to default color. + + - parameter rgba: String value. + */ +#if os(macOS) + public convenience init?(_ rgba: String, defaultColor: NSColor = NSColor.clear) { + guard let color = try? Color(rgba_throws: rgba) else { + self.init(cgColor: defaultColor.cgColor) + return + } + self.init(cgColor: color.cgColor) + } +#else + public convenience init(_ rgba: String, defaultColor: UIColor = UIColor.clear) { + guard let color = try? UIColor(rgba_throws: rgba) else { + self.init(cgColor: defaultColor.cgColor) + return + } + self.init(cgColor: color.cgColor) + } +#endif + + /** + Hex string of a UIColor instance, throws error. + + - parameter includeAlpha: Whether the alpha should be included. + */ + public func hexStringThrows(_ includeAlpha: Bool = true) throws -> String { + var r: CGFloat = 0 + var g: CGFloat = 0 + var b: CGFloat = 0 + var a: CGFloat = 0 + self.getRed(&r, green: &g, blue: &b, alpha: &a) + + guard r >= 0 && r <= 1 && g >= 0 && g <= 1 && b >= 0 && b <= 1 else { + let error = UIColorInputError.unableToOutputHexStringForWideDisplayColor + print(error.localizedDescription) + throw error + } + + if (includeAlpha) { + return String(format: "#%02X%02X%02X%02X", + Int(round(r * 255)), Int(round(g * 255)), + Int(round(b * 255)), Int(round(a * 255))) + } else { + return String(format: "#%02X%02X%02X", Int(round(r * 255)), + Int(round(g * 255)), Int(round(b * 255))) + } + } + + /** + Hex string of a UIColor instance, fails to empty string. + + - parameter includeAlpha: Whether the alpha should be included. + */ + public func hexString(_ includeAlpha: Bool = true) -> String { + guard let hexString = try? hexStringThrows(includeAlpha) else { + return "" + } + return hexString + } +} diff --git a/Demo/Pods/UIColor_Hex_Swift/HEXColor/UIColorInputError.swift b/Demo/Pods/UIColor_Hex_Swift/HEXColor/UIColorInputError.swift new file mode 100644 index 0000000..bdcaae4 --- /dev/null +++ b/Demo/Pods/UIColor_Hex_Swift/HEXColor/UIColorInputError.swift @@ -0,0 +1,36 @@ +// +// UIColorInputError.swift +// HEXColor-iOS +// +// Created by Sergey Pugach on 2/2/18. +// Copyright © 2018 P.D.Q. All rights reserved. +// + +import Foundation + +public enum UIColorInputError: Error { + + case missingHashMarkAsPrefix(String) + case unableToScanHexValue(String) + case mismatchedHexStringLength(String) + case unableToOutputHexStringForWideDisplayColor +} + +extension UIColorInputError: LocalizedError { + + public var errorDescription: String? { + switch self { + case .missingHashMarkAsPrefix(let hex): + return "Invalid RGB string, missing '#' as prefix in \(hex)" + + case .unableToScanHexValue(let hex): + return "Scan \(hex) error" + + case .mismatchedHexStringLength(let hex): + return "Invalid RGB string from \(hex), number of characters after '#' should be either 3, 4, 6 or 8" + + case .unableToOutputHexStringForWideDisplayColor: + return "Unable to output hex string for wide display color" + } + } +} diff --git a/Demo/Pods/UIColor_Hex_Swift/LICENSE b/Demo/Pods/UIColor_Hex_Swift/LICENSE new file mode 100644 index 0000000..b73ee02 --- /dev/null +++ b/Demo/Pods/UIColor_Hex_Swift/LICENSE @@ -0,0 +1,21 @@ +The MIT License (MIT) + +Copyright (c) 2014 R0CKSTAR + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. \ No newline at end of file diff --git a/Demo/Pods/UIColor_Hex_Swift/README.md b/Demo/Pods/UIColor_Hex_Swift/README.md new file mode 100644 index 0000000..9420955 --- /dev/null +++ b/Demo/Pods/UIColor_Hex_Swift/README.md @@ -0,0 +1,81 @@ +

+ +

+ +UIColor+Hex, now Swift. +[![Build Status](https://travis-ci.org/yeahdongcn/UIColor-Hex-Swift.svg?branch=master)](https://travis-ci.org/yeahdongcn/UIColor-Hex-Swift) [![codecov.io](https://codecov.io/gh/yeahdongcn/UIColor-Hex-Swift/branch/master/graphs/badge.svg)](https://codecov.io/gh/yeahdongcn/UIColor-Hex-Swift/branch/master) ![](https://img.shields.io/badge/Swift-5.0-blue.svg?style=flat) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) ![](https://img.shields.io/badge/license-MIT-blue.svg?style=flat) +================= +Convenience method for creating autoreleased color using RGBA hex string. + +```swift + // Solid color + let strokeColor = UIColor("#FFCC00").cgColor + + // Color with alpha + let fillColor = UIColor("#FFCC00DD").cgColor + + // Supports shorthand 3 character representation + let backgroundColor = UIColor("#FFF") + + // Supports shorthand 4 character representation (with alpha) + let menuTextColor = UIColor("#013E") + + // "#FF0000FF" + let hexString = UIColor.red.hexString() + + // Convert shorthand 4 character representation (with alpha) from argb to rgba + if let rgba = "#AFFF".argb2rgba { + let androidBackgroundColor = UIColor(rgba) + } + + // Convert 8 character representation (with alpha) from argb to rgba + if let rgba = "#AAFFFFFF".argb2rgba { + let androidFrontColor = UIColor(rgba) + } +``` +## Release Notes + +* Upgrade to Swift 5. +* macOS gets supported. + +## Installation + +### [Swift Package Manager](https://github.com/apple/swift-package-manager) + +To add a package dependency to your Xcode project, select File > Swift Packages > Add Package Dependency and enter https://github.com/yeahdongcn/UIColor-Hex-Swift to the text field. + +### [CocoaPods](http://cocoapods.org) + +Simply add the following lines to your `Podfile`: +```ruby +# required by CocoaPods 0.36.0.rc.1 for Swift Pods +use_frameworks! + +pod 'UIColor_Hex_Swift', '~> 5.1.7' +``` + +Then import it where you use it: +```swift +import UIColor_Hex_Swift +``` + +*(CocoaPods v0.36 or later required. See [this blog post](http://blog.cocoapods.org/Pod-Authors-Guide-to-CocoaPods-Frameworks/) for details.)* + +### [Carthage](http://github.com/Carthage/Carthage) + +Simply add the following line to your `Cartfile`: + +```ruby +github "yeahdongcn/UIColor-Hex-Swift" >= 5.1.7 +``` + +Then add the HexColor.framework to your frameworks list in the Xcode project. + +Then import it where you use it: +```swift +import HEXColor +``` + +--- + +See more in [RSBarcodes_Swift](https://github.com/yeahdongcn/RSBarcodes_Swift) and [objc version](https://github.com/yeahdongcn/RSBarcodes)