✨ Add Extensions nibble.

Author: connor-ricks

.swiftpm/xcode/package.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

.swiftpm/xcode/package.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEWorkspaceSharedSettings_AutocreateContextsIfNeeded</key>
+	<true/>
+</dict>
+</plist>

.swiftpm/xcode/xcshareddata/xcschemes/Extensions.xcscheme

@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1500"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "Extensions"
+               BuildableName = "Extensions"
+               BlueprintName = "Extensions"
+               ReferencedContainer = "container:">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "Extensions"
+            BuildableName = "Extensions"
+            BlueprintName = "Extensions"
+            ReferencedContainer = "container:">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

Package.swift

@@ -0,0 +1,20 @@
+// swift-tools-version: 5.8.0
+
+import PackageDescription
+
+let package = Package(
+    name: "swift-nibbles",
+    platforms: [
+        .iOS(.v16),
+        .macOS(.v13),
+        .tvOS(.v16),
+        .watchOS(.v9),
+    ],
+    products: [
+        .library(name: "Extensions", targets: ["Extensions"]),
+    ],
+    targets: [
+        .target(name: "Extensions"),
+        .testTarget(name: "ExtensionsTests", dependencies: ["Extensions"]),
+    ]
+)

Sources/Extensions/Array.swift

@@ -0,0 +1,15 @@
+import Foundation
+
+extension Array {
+    /// Splits the array into chunks of the specified size.
+    public func chunked(into size: Int) -> [[Element]] {
+        guard size > 0 else {
+            assertionFailure("Size must not be zero.")
+            return []
+        }
+        
+        return stride(from: 0, to: count, by: size).map {
+            Array(self[$0 ..< Swift.min($0 + size, count)])
+        }
+    }
+}

Sources/Extensions/Collection.swift

@@ -0,0 +1,10 @@
+import Foundation
+
+extension Collection {
+    /// Attempts to retrieve the item at the provided index, returning `nil` if the index is beyond the bounds of the collection.
+    ///
+    /// - Parameter index: The index from which to retrieve an item.
+    public subscript(safe index: Index) -> Iterator.Element? {
+        return indices.contains(index) ? self[index] : nil
+    }
+}

Sources/Extensions/Color.swift

@@ -0,0 +1,57 @@
+#if canImport(UIKit)
+import UIKit
+import SwiftUI
+
+extension Color: Codable {
+
+    // MARK: Decodable
+
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        let r = try container.decode(Double.self, forKey: .red)
+        let g = try container.decode(Double.self, forKey: .green)
+        let b = try container.decode(Double.self, forKey: .blue)
+        let a = try container.decode(Double.self, forKey: .alpha)
+        self.init(.sRGB, red: r, green: g, blue: b, opacity: a)
+    }
+
+    // MARK: Codable
+
+    public func encode(to encoder: Encoder) throws {
+        guard let colorComponents = colorComponents else {
+            throw EncodingError.invalidValue(self, .init(
+                codingPath: CodingKeys.allCases,
+                debugDescription: "Unable to get colorComponents from Color."
+            ))
+        }
+
+        var container = encoder.container(keyedBy: CodingKeys.self)
+        try container.encode(colorComponents.red, forKey: .red)
+        try container.encode(colorComponents.green, forKey: .green)
+        try container.encode(colorComponents.blue, forKey: .blue)
+        try container.encode(colorComponents.alpha, forKey: .alpha)
+    }
+    
+    private var colorComponents: (red: CGFloat, green: CGFloat, blue: CGFloat, alpha: CGFloat)? {
+        var r: CGFloat = 0
+        var g: CGFloat = 0
+        var b: CGFloat = 0
+        var a: CGFloat = 0
+
+        guard UIColor(self).getRed(&r, green: &g, blue: &b, alpha: &a) else {
+            return nil
+        }
+
+        return (r, g, b, a)
+    }
+
+    // MARK: CodingKeys
+
+    enum CodingKeys: String, CodingKey, CaseIterable {
+        case red
+        case green
+        case blue
+        case alpha
+    }
+}
+#endif

Sources/Extensions/Comparable.swift

@@ -0,0 +1,11 @@
+import Foundation
+
+extension Comparable {
+    /// Clamps the value to the provided range.
+    ///
+    /// - Parameter limits: The range to clamp the value to.
+    /// - Returns: The value clamped to the provided range.
+    public func clamped(to limits: ClosedRange<Self>) -> Self {
+        return min(max(self, limits.lowerBound), limits.upperBound)
+    }
+}

Sources/Extensions/EdgeInsets.swift

@@ -0,0 +1,32 @@
+import SwiftUI
+
+extension EdgeInsets {
+    /// A value that represents an `EdgeInsets` with zero around all edges.
+    public static let zero: EdgeInsets = .init(padding: 0)
+
+    /// Creates `EdgeInsets` using the provided `padding` for all edges.
+    ///
+    /// - Parameter padding: The value to be used for each edge.
+    public init(padding: CGFloat) {
+        self.init(
+            top: padding,
+            leading: padding,
+            bottom: padding,
+            trailing: padding
+        )
+    }
+
+    /// Creates `EdgeInsets` using the provided `vertical` and `horizontal` values.
+    /// 
+    /// - Parameters:
+    ///   - vertical: The value to be used for both the `top` and `bottom` edges.
+    ///   - horizontal: The value to be used for both the `leading` and `trailing` edges.
+    public init(vertical: CGFloat, horizontal: CGFloat) {
+        self.init(
+            top: vertical,
+            leading: horizontal,
+            bottom: vertical,
+            trailing: horizontal
+        )
+    }
+}