.github/FUNDING.yml

@@ -0,0 +1 @@
+github: ra1028

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,66 @@
+name: Bug Report
+description: File a bug report
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: This is not a bug caused by platform.
+          required: true
+        - label: Reviewed the README and documentation.
+          required: true
+        - label: Checked existing issues & PRs to ensure not duplicated.
+          required: true
+
+  - type: textarea
+    attributes:
+      label: What happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Reproduction Steps
+      value: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: Swift Version
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: Library Version
+    validations:
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: Platform
+      multiple: true
+      options:
+        - iOS
+        - tvOS
+        - macOS
+        - watchOS
+
+  - type: textarea
+    attributes:
+      label: Scrrenshot/Video/Gif
+      placeholder: |
+        Drag and drop screenshot, video, or gif here if you have.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/documentation_request.yml

@@ -0,0 +1,27 @@
+name: Documentation Request
+description: Suggest a new doc/example or ask a question about an existing one
+title: "[Doc Request]: "
+labels: ["documentation"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: Reviewed the README and documentation.
+          required: true
+        - label: Confirmed that this is uncovered by existing docs or examples.
+          required: true
+        - label: Checked existing issues & PRs to ensure not duplicated.
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      placeholder: Describe what the scenario you think is uncovered by the existing ones and why you think it should be covered.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Motivation & Context
+      placeholder: Feel free to describe any additional context, such as why you thought the scenario should be covered.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,42 @@
+name: Feature Request
+description: Suggest a new idea of feature
+title: "[Feat Request]: "
+labels: ["enhancement"]
+body:
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: Reviewed the README and documentation.
+          required: true
+        - label: Checked existing issues & PRs to ensure not duplicated.
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      placeholder: Describe the feature that you want to propose.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Example Use Case
+      placeholder: Describe an example use case that the feature is useful.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Alternative Solution
+      placeholder: Describe alternatives solutions that you've considered.
+
+  - type: textarea
+    attributes:
+      label: Proposed Solution
+      placeholder: Describe how we can achieve the feature you'd like to suggest.
+
+  - type: textarea
+    attributes:
+      label: Motivation & Context
+      placeholder: Feel free to describe any additional context, such as why you want to suggest this feature.

.github/pull_request_template.md

@@ -0,0 +1,19 @@
+## Pull Request Type
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactoring
+- [ ] Documentation update
+- [ ] Chore
+
+## Issue for this PR
+
+Link:
+
+## Description
+
+## Motivation and Context
+
+## Impact on Existing Code
+
+## Screenshot/Video/Gif

.github/workflows/docs.yml

@@ -0,0 +1,28 @@
+# https://github.com/actions/virtual-environments
+
+name: docs
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Test
+    runs-on: macos-12
+    strategy:
+      matrix:
+        xcode_version:
+          - 13.3
+    env:
+      DEVELOPER_DIR: /Applications/Xcode_${{ matrix.xcode_version }}.app
+    steps:
+      - uses: actions/checkout@v2
+      - name: Build docs
+        run: make docs
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs

.github/workflows/test.yml

@@ -1,25 +1,22 @@
 # https://github.com/actions/virtual-environments
 
-name: GitHub Actions
+name: test
+
 on:
   pull_request:
   push:
     branches:
       - main
   workflow_dispatch:
-    branches:
-      - main
+
 jobs:
   test:
     name: Test
-    runs-on: macos-10.15
+    runs-on: macos-12
     strategy:
       matrix:
         xcode_version:
-          - 12.4
-          # Should revisit these versions once Big sur will be available.
-          # - 12.5.1
-          # - 13.0
+          - 13.3
     env:
       DEVELOPER_DIR: /Applications/Xcode_${{ matrix.xcode_version }}.app
     steps:
@@ -28,45 +25,25 @@ jobs:
         run: |
           swift --version
           xcodebuild -version
-      - name: Test for macOS
-        run: xcodebuild test -scheme Hooks -destination "platform=macOS"
-      - name: Test for iOS
-        run: xcodebuild test -scheme Hooks -destination "platform=iOS Simulator,name=iPhone 12 Pro"
-      - name: Test for tvOS
-        run: xcodebuild test -scheme Hooks -destination "platform=tvOS Simulator,name=Apple TV"
-      - name: Build for watchOS
-        run: WATCHOS=true xcodebuild build -scheme Hooks -destination "platform=watchOS Simulator,name=Apple Watch Series 6 - 44mm"
+      - name: Test library
+        run: make test-library
+      - name: Build examples
+        run: make build-examples
 
-  build-examples:
-    name: Build examples
-    runs-on: macos-10.15
+  validation:
+    name: Validation
+    runs-on: macos-12
     env:
-      DEVELOPER_DIR: /Applications/Xcode_12.4.app
-      OLD_XCODE_APP: /Applications/Xcode_11.7.app
-      OLD_TARGET_OS: 13.7
-      OLD_RUNTIME_NAME: com.apple.CoreSimulator.SimRuntime.iOS-13-7
-    defaults:
-      run:
-        working-directory: Examples
+      DEVELOPER_DIR: /Applications/Xcode_13.3.app
     steps:
       - uses: actions/checkout@v2
-      - name: Show environments
+      - name: Validate lint
+        run: make lint
+      - name: Validate format
         run: |
-          swift --version
-          xcodebuild -version
-      - name: Prepare old OS simulator
+          make format
+          if [ -n "$(git status --porcelain)" ]; then echo "Make sure that the code is formated by 'make format'."; exit 1; fi
+      - name: Validate example project
         run: |
-          sudo mkdir -p /Library/Developer/CoreSimulator/Profiles/Runtimes
-          sudo ln -s $OLD_XCODE_APP/Contents/Developer/Platforms/iPhoneOS.platform/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS.simruntime /Library/Developer/CoreSimulator/Profiles/Runtimes/iOS\ $OLD_TARGET_OS.simruntime
-          xcrun simctl list runtimes
-          xcrun simctl list devices $OLD_TARGET_OS
-      - name: Build TheMovieDB
-        run: xcodebuild build -scheme TheMovieDB-MVVM -destination "platform=iOS Simulator,name=iPhone 12 Pro"
-      - name: Test TheMovieDB
-        run: xcodebuild test -scheme TheMovieDB-MVVM-Tests -destination "platform=iOS Simulator,name=iPhone 12 Pro"
-      - name: Build Basic
-        run: xcodebuild build -scheme BasicUsage -destination "platform=iOS Simulator,name=iPhone 12 Pro"
-      - name: Build Legacy
-        run: xcodebuild build -scheme Todo -destination "platform=iOS Simulator,name=iPhone 12 Pro"
-      - name: Build Legacy with iOS13
-        run: xcodebuild build -scheme Todo -destination "platform=iOS Simulator,name=iPhone 11 Pro,OS=$OLD_TARGET_OS"
+          make proj
+          if [ -n "$(git status --porcelain)" ]; then echo "Make sure that 'Examples/Examples.xcodeproj' is formated by 'make proj'."; exit 1; fi

.gitignore

@@ -19,7 +19,6 @@ DerivedData
 build/
 archive/
 *.xcframework
-
-## SwiftPM
 .swiftpm
 .build
+docs

.swift-format.json → .swift-format

@@ -7,7 +7,8 @@
         "accessLevel": "private"
     },
     "indentConditionalCompilationBlocks": true,
-    "lineBreakAroundMultilineExpressionChainComponents": true,
+    "indentSwitchCaseLabels": false,
+    "lineBreakAroundMultilineExpressionChainComponents": false,
     "lineBreakBeforeControlFlowKeywords": true,
     "lineBreakBeforeEachArgument": true,
     "lineBreakBeforeEachGenericRequirement": true,
@@ -21,14 +22,14 @@
         "AmbiguousTrailingClosureOverload": true,
         "BeginDocumentationCommentWithOneLineSummary": false,
         "DoNotUseSemicolons": true,
-        "DontRepeatTypeInStaticProperties": true,
-        "FileprivateAtFileScope": true,
+        "DontRepeatTypeInStaticProperties": false,
+        "FileScopedDeclarationPrivacy": true,
         "FullyIndirectEnum": true,
         "GroupNumericLiterals": true,
         "IdentifiersMustBeASCII": true,
-        "NeverForceUnwrap": true,
+        "NeverForceUnwrap": false,
         "NeverUseForceTry": true,
-        "NeverUseImplicitlyUnwrappedOptionals": true,
+        "NeverUseImplicitlyUnwrappedOptionals": false,
         "NoAccessLevelOnExtensionDeclaration": false,
         "NoBlockComments": true,
         "NoCasesWithOnlyFallthrough": true,
@@ -42,11 +43,13 @@
         "OnlyOneTrailingClosureArgument": false,
         "OrderedImports": true,
         "ReturnVoidInsteadOfEmptyTuple": true,
+        "UseEarlyExits": false,
         "UseLetInEveryBoundCaseVariable": true,
         "UseShorthandTypeNames": true,
         "UseSingleLinePropertyGetter": true,
-        "UseSynthesizedInitializer": false,
+        "UseSynthesizedInitializer": true,
         "UseTripleSlashForDocumentationComments": true,
+        "UseWhereClausesInForLoops": false,
         "ValidateDocumentationComments": false
     }
 }

Examples/BasicUsage/APIRequestPage.swift

@@ -7,16 +7,15 @@ struct Post: Codable {
     let body: String
 }
 
-func useFetchPosts() -> (phase: AsyncPhase<[Post], Error>, fetch: () -> Void) {
-    let url = URL(string: "https://jsonplaceholder.typicode.com/posts").unsafelyUnwrapped
-    let (phase, subscribe) = usePublisherSubscribe {
-        URLSession.shared.dataTaskPublisher(for: url)
-            .map(\.data)
-            .decode(type: [Post].self, decoder: JSONDecoder())
-            .receive(on: DispatchQueue.main)
+func useFetchPosts() -> (phase: AsyncPhase<[Post], Error>, fetch: () async -> Void) {
+    let url = URL(string: "https://jsonplaceholder.typicode.com/posts")!
+    let (phase, fetch) = useAsyncPerform { () throws -> [Post] in
+        let decoder = JSONDecoder()
+        let (data, _) = try await URLSession.shared.data(from: url)
+        return try decoder.decode([Post].self, from: data)
     }
 
-    return (phase: phase, fetch: subscribe)
+    return (phase: phase, fetch: fetch)
 }
 
 struct APIRequestPage: HookView {
@@ -44,7 +43,9 @@ struct APIRequestPage: HookView {
         }
         .navigationTitle("API Request")
         .background(Color(.systemBackground).ignoresSafeArea())
-        .onAppear(perform: fetch)
+        .task {
+            await fetch()
+        }
     }
 
     func postRows(_ posts: [Post]) -> some View {
@@ -58,11 +59,18 @@ struct APIRequestPage: HookView {
         }
     }
 
-    func errorRow(_ error: Error, retry: @escaping () -> Void) -> some View {
+    func errorRow(_ error: Error, retry: @escaping () async -> Void) -> some View {
         VStack {
-            Text("Error: \(error.localizedDescription)").fixedSize(horizontal: false, vertical: true)
+            Text("Error: \(error.localizedDescription)")
+                .fixedSize(horizontal: false, vertical: true)
+
             Divider()
-            Button("Refresh", action: retry)
+
+            Button("Refresh") {
+                Task {
+                    await retry()
+                }
+            }
         }
     }
 }