Release 0.5.0 (#7)

* Introduce Parent & Child View Models definitions

* Update StorageController definitions, remove Storable protocol

* Add two & three constants

* Update README to update contents

README.md

@@ -22,6 +22,4 @@ A collection of reusable logic to boost Apple platform apps development process.
 │   │   └── AlertStateModifier.swift
 │   ├── SystemImage.swift
 │   └── ViewModel.swift
-├── Protocols
-│   └── Storable.swift
 ```

Sources/Caffeine/Controllers/StorageController.swift

@@ -9,18 +9,30 @@ import Foundation
 
 // Defines convenience methods for ´Codable´ types storage.
 public protocol StorageController {
-    func read<T>(with key: String) throws -> T? where T: Codable
-    func write<T>(with key: String, value: T) throws where T: Codable
+    func read<T>(with key: String) throws -> T? where T: Decodable
+    func write<T>(with key: String, value: T) throws where T: Encodable
 }
 
 extension UserDefaults: StorageController {
-    public func read<T>(with key: String) throws -> T? where T : Codable {
+    public func read<T>(with key: String) throws -> T? where T : Decodable {
         guard let data = data(forKey: key) else { return nil }
         return try JSONDecoder().decode(T.self, from: data)
     }
 
-    public func write<T>(with key: String, value: T) throws where T : Codable {
+    public func write<T>(with key: String, value: T) throws where T : Encodable {
         let data = try JSONEncoder().encode(value)
         setValue(data, forKey: key)
     }
 }
+
+public extension Decodable {
+    static func read(_ controller: StorageController = UserDefaults.standard, cacheKey: String) throws -> Self? {
+        return try controller.read(with: cacheKey)
+    }
+}
+
+public extension Encodable {
+    func write(_ controller: StorageController = UserDefaults.standard, cacheKey: String) throws {
+        try controller.write(with: cacheKey, value: self)
+    }
+}

Sources/Caffeine/Extensions/AdditiveArithmetic+Caffeine.swift

@@ -9,6 +9,8 @@ import Foundation
 
 public extension AdditiveArithmetic where Self : ExpressibleByIntegerLiteral {
     @inlinable static var one: Self { 1 }
+    @inlinable static var two: Self { 2 }
+    @inlinable static var three: Self { 3 }
 }
 
 public extension AdditiveArithmetic where Self : ExpressibleByFloatLiteral {

Sources/Caffeine/Presentation/ViewModel.swift

@@ -20,3 +20,24 @@ public extension ViewModel {
         }
     }
 }
+
+/// A ´ViewModel´ which can be delegated to handle ´ChildViewModel´ actions.
+public protocol ParentViewModel: Caffeine.ViewModel {
+    associatedtype ChildAction
+    func handle(childAction: ChildAction) async
+}
+
+/// A ´ViewModel´ that can delegate its actions to a ´ParentViewModel´.
+public protocol ChildViewModel<Parent>: ViewModel where Parent: ParentViewModel, Parent.ChildAction == Self.Action {
+    associatedtype Parent
+    var parent: Parent { get set }
+}
+
+public extension ParentViewModel {
+    func handle(childAction: ChildAction) {
+        Task {
+            await handle(childAction: childAction)
+        }
+    }
+}
+