Initial commit

Author: EricRabil

.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+/.build
+/Packages
+/*.xcodeproj
+xcuserdata/
+DerivedData/
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata

Package.resolved

@@ -0,0 +1,26 @@
+// swift-tools-version:5.3
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "BarcelonaFoundation",
+    platforms: [
+        .macOS(.v10_14), .iOS(.v13)
+    ],
+    products: [
+        .library(
+            name: "BarcelonaFoundation",
+            targets: ["BarcelonaFoundation"]),
+    ],
+    dependencies: [
+        .package(url: "https://github.com/EricRabil/Pwomise", .upToNextMajor(from: "1.0.3")),
+        .package(url: "https://github.com/EricRabil/Swexy", .upToNextMajor(from: "1.0.1")),
+        .package(url: "https://github.com/EricRabil/Swog", .branch("main"))
+    ],
+    targets: [
+        .target(
+            name: "BarcelonaFoundation",
+            dependencies: ["Pwomise", "Swexy", "Swog"])
+    ]
+)

Package.swift

@@ -0,0 +1,3 @@
+# BarcelonaFoundation
+
+A description of this package.

README.md

@@ -0,0 +1,12 @@
+//
+//  BarcelonaFoundation.swift
+//  BarcelonaFoundation
+//
+//  Created by Eric Rabil on 7/31/21.
+//  Copyright © 2021 Eric Rabil. All rights reserved.
+//
+
+import Foundation
+@_exported import Swexy
+@_exported import Pwomise
+@_exported import Swog

Sources/BarcelonaFoundation/BarcelonaFoundation.swift

@@ -0,0 +1,22 @@
+//
+//  Color.swift
+//  BarcelonaFoundation
+//
+//  Created by Eric Rabil on 7/24/21.
+//  Copyright © 2021 Eric Rabil. All rights reserved.
+//
+
+import Foundation
+import CoreGraphics
+
+public struct Color: Codable, Hashable {
+    let red: CGFloat
+    let blue: CGFloat
+    let green: CGFloat
+    let alpha: CGFloat
+}
+
+public struct DynamicColor: Codable, Hashable {
+    let light: Color?
+    let dark: Color?
+}

Sources/BarcelonaFoundation/Color.swift

@@ -0,0 +1,121 @@
+//
+//  Debouncer.swift
+//  CoreBarcelona
+//
+//  Created by Eric Rabil on 8/18/20.
+//  Copyright © 2020 Eric Rabil. All rights reserved.
+//
+
+import Foundation
+
+/// Fires a callback after the call function has not been called for the specified delay
+open class Debouncer {
+    /// The duration in which calls will be throttled
+    var delay: Double
+    
+    /// The timer being tracked by the debouncer
+    weak var timer: Timer?
+
+    public init(delay: Double) {
+        self.delay = delay
+    }
+    
+    /// Fires a callback function if and only if there are no subsequent calls during the debounce period
+    /// - Parameter callback: callback function to call
+    public func call(_ callback: @escaping () -> ()) {
+        timer?.invalidate()
+        
+        let nextTimer = Timer.scheduledTimer(withTimeInterval: delay, repeats: false) { _ in
+            callback()
+        }
+        
+        timer = nextTimer
+    }
+}
+
+/// Manages a set of debouncers associated with a string
+open class IdentifiableDebounceManager {
+    /// Debouncers for the given identifiers
+    private var debouncers: [String: Debouncer] = [:]
+    
+    /// The duration in which calls for a given identifier will be throttled
+    private let delay: Double
+    
+    public init(_ delay: Double) {
+        self.delay = delay
+    }
+    
+    /// Returns or constructs a debouncer for the given id
+    /// - Parameter id: id to resolve
+    /// - Returns: debouncer object
+    private func debouncer(forID id: String) -> Debouncer {
+        if let debouncer = debouncers[id] {
+            return debouncer
+        }
+        
+        debouncers[id] = Debouncer(delay: delay)
+        
+        return debouncers[id]!
+    }
+    
+    /// Drops a debouncer from storage
+    /// - Parameter id: identifier of the debouncer to clear
+    private func clearDebouncer(forID id: String) {
+        if let index = debouncers.index(forKey: id) {
+            debouncers.remove(at: index)
+        }
+    }
+    
+    /// Submits a task to an identifiable debouncer
+    /// - Parameters:
+    ///   - id: identifier of the debouncer to call
+    ///   - cb: task to execute if conditions are met
+    public func submit(id: String, cb: @escaping () -> ()) {
+        debouncer(forID: id).call {
+            RunLoop.main.schedule {
+                self.clearDebouncer(forID: id)
+            }
+            
+            cb()
+        }
+    }
+}
+
+/// Manages a set of managers with the specified categories
+open class CategorizedDebounceManager<P: Hashable> {
+    /// Ledger of category to debounce manager
+    private var debouncers: [P: IdentifiableDebounceManager] = [:]
+    
+    /// Default delay to use for debounce managers
+    private let defaultDelay: Double = 1 / 10
+    
+    /// Constructs a categorized debounce manager
+    /// - Parameter configuration: ledger of debounce categories to delays
+    public init(_ configuration: [P: Double]) {
+        configuration.forEach {
+            debouncers[$0.key] = .init($0.value)
+        }
+    }
+    
+    /// Returns or constructs a debouncer for the given category
+    /// - Parameter category: category of the debouncer to resolve
+    /// - Returns: a debounce manager
+    private func debouncer(for category: P) -> IdentifiableDebounceManager {
+        if let debouncer = debouncers[category] {
+            return debouncer
+        }
+        
+        debouncers[category] = .init(defaultDelay)
+        
+        return debouncers[category]!
+    }
+    
+    /// Submits a task to a debouncer on a given category
+    /// - Parameters:
+    ///   - id: identifier of the debouncer
+    ///   - category: category of the debouncer
+    ///   - cb: task to execute if conditions are met
+    public func submit(_ id: String, category: P, cb: @escaping () -> ()) {
+        debouncer(for: category).submit(id: id, cb: cb)
+    }
+}

Sources/BarcelonaFoundation/Debouncer.swift

@@ -0,0 +1,53 @@
+//
+//  ExpiringCollection.swift
+//  BarcelonaFoundation
+//
+//  Created by Eric Rabil on 7/26/21.
+//  Copyright © 2021 Eric Rabil. All rights reserved.
+//
+
+import Foundation
+import OSLog
+
+public class ExpiringCollection<Element: Hashable>: Collection {
+    public private(set) var inner = Set<Element>()
+    
+    public typealias Index = Set<Element>.Index
+    
+    public let threshold: TimeInterval = 60
+    public var runLoop: RunLoop = .current
+    
+    private var expirationTimers = [Element: Timer]()
+    
+    public var startIndex: Set<Element>.Index { inner.startIndex }
+    public var endIndex: Set<Element>.Index { inner.endIndex }
+    
+    public init() {
+        
+    }
+    
+    public func insert(_ item: Element) {
+        inner.insert(item)
+        expirationTimers[item]?.invalidate()
+        
+        runLoop.schedule {
+            self.expirationTimers[item] = Timer.scheduledTimer(withTimeInterval: self.threshold, repeats: false) { timer in
+                self.expirationTimers[item] = nil
+                self.inner.remove(item)
+            }
+        }
+    }
+    
+    public func remove(_ item: Element) {
+        inner.remove(item)
+        expirationTimers[item]?.invalidate()
+    }
+    
+    public subscript(index: Set<Element>.Index) -> Element {
+        inner[index]
+    }
+    
+    public func index(after i: Set<Element>.Index) -> Set<Element>.Index {
+        inner.index(after: i)
+    }
+}