2.0.1

Author: nathantannar4

.github/workflows/swift.yml

@@ -0,0 +1,32 @@
+# This workflow will build a Swift project
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-swift
+
+name: Build
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Xcode version
+      run: sudo xcode-select -s /Applications/Xcode_16.2.app/Contents/Developer
+    - name: Show available destinations
+      run: xcodebuild -scheme Ignition -showdestinations
+    - name: Build for macOS
+      run: xcodebuild -scheme Ignition -destination 'platform=macOS' build
+    - name: Build for Catalyst
+      run: xcodebuild -scheme Ignition -destination 'platform=macOS,variant=Mac Catalyst' build
+    - name: Build for iOS
+      run: xcodebuild -scheme Ignition -destination 'platform=iOS Simulator,name=iPhone 16' build
+    - name: Build for watchOS
+      run: xcodebuild -scheme Ignition -destination 'platform=watchOS Simulator,name=Apple Watch Ultra 2 (49mm)' build
+    - name: Build for tvOS
+      run: xcodebuild -scheme Ignition -destination 'platform=tvOS Simulator,name=Apple TV 4K (3rd generation)' build
+    - name: Build for visionOS
+      run: xcodebuild -scheme Ignition -destination 'platform=visionOS Simulator,name=Apple Vision Pro' build

.spi.yml

@@ -0,0 +1,13 @@
+version: 1
+builder:
+  configs:
+    - documentation_targets: [Ignition]
+      platform: macos
+    - documentation_targets: [Ignition]
+      platform: ios
+    - documentation_targets: [Ignition]
+      platform: tvos
+    - documentation_targets: [Ignition]
+      platform: watchos
+    - documentation_targets: [Ignition]
+      platform: visionos

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

@@ -19,7 +19,7 @@ let package = Package(
         ),
     ],
     dependencies: [
-        .package(url: "https://github.com/nathantannar4/Engine", from: "2.0.4"),
+        .package(url: "https://github.com/nathantannar4/Engine", from: "2.1.14"),
     ],
     targets: [
         .target(

.swiftpm/xcode/xcshareddata/xcschemes/Ignition.xcscheme

@@ -50,6 +50,10 @@ let package = Package(
 )
 ```
 
+## Documentation
+
+Detailed documentation is available [here](https://swiftpackageindex.com/nathantannar4/Ignition/main/documentation/ignition).
+
 ## Effects
 
 `Ignition` provides 5 built in effects, but you can also make your own by conforming to the `ViewEffect` protocol.

Example/Example.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -0,0 +1,58 @@
+//
+// Copyright (c) Nathan Tannar
+//
+
+import SwiftUI
+
+@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *)
+extension ViewEffect where Self == BlurEffect {
+
+    /// A ``ViewEffect`` that applies a blur to the view
+    public static func blur(
+        radius: Double,
+        opaque: Bool = false
+    ) -> BlurEffect {
+        BlurEffect(radius: radius, opaque: opaque)
+    }
+}
+
+/// A ``ViewEffect`` that applies a blur to the view
+@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *)
+@frozen
+public struct BlurEffect: ViewEffect {
+
+    public var radius: Double
+    public var opaque: Bool = false
+
+    @inlinable
+    public init(radius: Double, opaque: Bool = false) {
+        self.radius = radius
+        self.opaque = opaque
+    }
+
+    public func makeBody(configuration: Configuration) -> some View {
+        configuration.content
+            .blur(radius: radius * configuration.progress, opaque: opaque)
+    }
+}
+
+// MARK: - Previews
+
+@available(iOS 14.0, macOS 11.0, tvOS 14.0, watchOS 7.0, *)
+struct BlurEffect_Previews: PreviewProvider {
+    static var previews: some View {
+        VStack(spacing: 24) {
+            Text("Hello, World")
+                .scheduledEffect(
+                    .blur(radius: 5),
+                    interval: 1
+                )
+
+            Text("Hello, World")
+                .scheduledEffect(
+                    .blur(radius: 20),
+                    interval: 1
+                )
+        }
+    }
+}

Package.swift

@@ -14,6 +14,14 @@ extension PrimitiveButtonStyle {
     ) -> ChangeEffectButtonStyle<Effect> where Self == ChangeEffectButtonStyle<Effect> {
         ChangeEffectButtonStyle(effect: effect)
     }
+
+    /// A ``PrimitiveButtonStyle`` that runs a ``ViewEffect`` when pressed
+    public static func changeEffect<Effect: ViewEffect>(
+        effect: Effect,
+        animation: Animation
+    ) -> ChangeEffectButtonStyle<Effect> where Self == ChangeEffectButtonStyle<Effect> {
+        ChangeEffectButtonStyle(effect: effect, animation: animation)
+    }
 }
 
 /// A ``PrimitiveButtonStyle`` that runs a ``ViewEffect`` when pressed
@@ -24,12 +32,26 @@ public struct ChangeEffectButtonStyle<
 >: PrimitiveButtonStyle {
 
     public var effect: Effect
+    public var animation: ViewEffectAnimation
 
     @State private var trigger: UInt = 0
 
     @inlinable
-    public init(effect: Effect) {
+    public init(
+        effect: Effect,
+        animation: Animation
+    ) {
+        self.effect = effect
+        self.animation = .continuous(animation)
+    }
+
+    @inlinable
+    public init(
+        effect: Effect,
+        animation: ViewEffectAnimation = .default
+    ) {
         self.effect = effect
+        self.animation = animation
     }
 
     public func makeBody(configuration: Configuration) -> some View {
@@ -39,7 +61,7 @@ public struct ChangeEffectButtonStyle<
         } label: {
             configuration.label
         }
-        .changeEffect(effect, value: trigger)
+        .changeEffect(effect, value: trigger, animation: animation)
     }
 }
 

README.md

@@ -23,7 +23,7 @@ extension ViewEffect where Self == OffsetEffect {
     }
 
     /// A ``ViewEffect`` that moves the view between an offset
-    public static func offset(offset: CGPoint) -> OffsetEffect {
+    public static func offset(_ offset: CGPoint) -> OffsetEffect {
         OffsetEffect(offset: offset)
     }
 }