Merge branch 'main' into update-ci

Author: stephencelis

.github/workflows/format.yml

@@ -12,18 +12,16 @@ concurrency:
 jobs:
   swift_format:
     name: swift-format
-    runs-on: macos-13
+    runs-on: macos-15
+    permissions:
+      contents: write
     steps:
       - uses: actions/checkout@v4
-      - name: Select Xcode 14.3
-        run: sudo xcode-select -s /Applications/Xcode_14.3.app
-      - name: Install swift-format
-        run: brew install swift-format
+      - name: Select Xcode 16.2
+        run: sudo xcode-select -s /Applications/Xcode_16.2.app
       - name: Format
         run: make format
-      - uses: stefanzweifel/git-auto-commit-action@v4
+      - uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: Run swift-format
           branch: 'main'
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -5,3 +5,4 @@
 /*.swiftinterface
 /*.xcodeproj
 xcuserdata/
+.docc-build/

ComposableArchitecture.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -33,14 +33,12 @@ extension SpeechClient: DependencyKey {
   }
 
   static var previewValue: SpeechClient {
-    let isRecording = LockIsolated(false)
-    return Self(
+    Self(
       authorizationStatus: { .authorized },
       requestAuthorization: { .authorized },
       startTask: { _ in
         AsyncThrowingStream { continuation in
           Task { @MainActor in
-            isRecording.setValue(true)
             var finalText = """
               Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor \
               incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud \
@@ -50,7 +48,7 @@ extension SpeechClient: DependencyKey {
               officia deserunt mollit anim id est laborum.
               """
             var text = ""
-            while isRecording.value {
+            while !finalText.isEmpty {
               let word = finalText.prefix { $0 != " " }
               try await Task.sleep(for: .milliseconds(word.count * 50 + .random(in: 0...200)))
               finalText.removeFirst(word.count)

Examples/SyncUps/SyncUps/Dependencies/SpeechRecognizer.swift

@@ -64,7 +64,7 @@ format:
 		-path '*/Documentation.docc' -prune -o \
 		-name '*.swift' \
 		-not -path '*/.*' -print0 \
-		| xargs -0 swift format --ignore-unparsable-files --in-place
+		| xargs -0 xcrun swift-format --ignore-unparsable-files --in-place
 
 .PHONY: build-for-library-evolution format warm-simulator xcodebuild xcodebuild-raw
 

Makefile

@@ -26,7 +26,7 @@ let package = Package(
     .package(url: "https://github.com/pointfreeco/swift-dependencies", from: "1.4.0"),
     .package(url: "https://github.com/pointfreeco/swift-identified-collections", from: "1.1.0"),
     .package(url: "https://github.com/pointfreeco/swift-macro-testing", from: "0.2.0"),
-    .package(url: "https://github.com/pointfreeco/swift-navigation", from: "2.2.2"),
+    .package(url: "https://github.com/pointfreeco/swift-navigation", from: "2.3.0"),
     .package(url: "https://github.com/pointfreeco/swift-perception", from: "1.3.4"),
     .package(url: "https://github.com/pointfreeco/swift-sharing", "0.1.2"..<"3.0.0"),
     .package(url: "https://github.com/pointfreeco/xctest-dynamic-overlay", from: "1.3.0"),

Package.swift

@@ -26,7 +26,7 @@ let package = Package(
     .package(url: "https://github.com/pointfreeco/swift-dependencies", from: "1.4.0"),
     .package(url: "https://github.com/pointfreeco/swift-identified-collections", from: "1.1.0"),
     .package(url: "https://github.com/pointfreeco/swift-macro-testing", from: "0.2.0"),
-    .package(url: "https://github.com/pointfreeco/swift-navigation", from: "2.2.2"),
+    .package(url: "https://github.com/pointfreeco/swift-navigation", from: "2.3.0"),
     .package(url: "https://github.com/pointfreeco/swift-perception", from: "1.3.4"),
     .package(url: "https://github.com/pointfreeco/swift-sharing", "0.1.2"..<"3.0.0"),
     .package(url: "https://github.com/pointfreeco/xctest-dynamic-overlay", from: "1.3.0"),

[email protected]

@@ -7,13 +7,14 @@
 
 The Composable Architecture (TCA, for short) is a library for building applications in a consistent 
 and understandable way, with composition, testing, and ergonomics in mind. It can be used in 
-SwiftUI, UIKit, and more, and on any Apple platform (iOS, macOS, visionOS, tvOS, and watchOS).
+SwiftUI, UIKit, and more, and on any Apple platform (iOS, macOS, iPadOS, visionOS, tvOS, and watchOS).
 
 * [What is the Composable Architecture?](#what-is-the-composable-architecture)
 * [Learn more](#learn-more)
 * [Examples](#examples)
 * [Basic usage](#basic-usage)
 * [Documentation](#documentation)
+* [FAQ](#faq)
 * [Community](#community)
 * [Installation](#installation)
 * [Translations](#translations)
@@ -575,6 +576,11 @@ comfortable with the library:
 * [Concurrency][concurrency-article]
 * [Bindings][bindings-article]
 
+## FAQ
+
+We have a [dedicated article][faq-article] for all of the most frequently asked questions and
+comments people have concerning the library.
+
 ## Community
 
 If you want to discuss the Composable Architecture or have a question about how to use it to solve 
@@ -633,17 +639,13 @@ The following translations of this README have been contributed by members of th
 * [Russian](https://gist.github.com/SubvertDev/3317d0c3b35ed601be330d6fc0df5aba)
 * [Simplified Chinese](https://gist.github.com/sh3l6orrr/10c8f7c634a892a9c37214f3211242ad)
 * [Spanish](https://gist.github.com/pitt500/f5e32fccb575ce112ffea2827c7bf942)
+* [Turkish](https://gist.github.com/gokhanamal/93001244ef0c1cec58abeb1afc0de37c)
 * [Ukrainian](https://gist.github.com/barabashd/33b64676195ce41f4bb73c327ea512a8)
 
 If you'd like to contribute a translation, please [open a
 PR](https://github.com/pointfreeco/swift-composable-architecture/edit/main/README.md) with a link 
 to a [Gist](https://gist.github.com)!
 
-## FAQ
-
-We have a [dedicated article][faq-article] for all of the most frequently asked questions and 
-comments people have concerning the library.
-
 ## Credits and thanks
 
 The following people gave feedback on the library at its early stages and helped make the library 

README.md

@@ -217,7 +217,7 @@ However, one does not need to have any prior experience with these concepts. The
 [dependency-management-article]: <doc:DependencyManagement>
 [sharing-state-article]: <doc:SharingState>
 [navigation-article]: <doc:Navigation>
-[testing-article]: <doc:Testing>
+[testing-article]: <doc:TestingTCA>
 [migration-1.7-article]: <doc:MigratingTo1.7>
 [migration-1.10-article]: <doc:MigratingTo1.10>
 [sync-ups-tutorial]: <doc:BuildingSyncUps>

Sources/ComposableArchitecture/Documentation.docc/Articles/FAQ.md

@@ -252,7 +252,7 @@ doing much additional work.
 
 ## Testing your feature
 
-> Note: For more in-depth information on testing, see the dedicated <doc:Testing> 
+> Note: For more in-depth information on testing, see the dedicated <doc:TestingTCA> 
 article.
 
 To test use a `TestStore`, which can be created with the same information as the `Store`, but it 
@@ -464,7 +464,7 @@ let store = TestStore(initialState: Feature.State()) {
 
 That is the basics of building and testing a feature in the Composable Architecture. There are 
 _a lot_ more things to be explored. Be sure to check out the <doc:MeetComposableArchitecture> 
-tutorial, as well as dedicated articles on <doc:DependencyManagement>, <doc:Testing>, 
+tutorial, as well as dedicated articles on <doc:DependencyManagement>, <doc:TestingTCA>, 
 <doc:Navigation>, <doc:Performance>, and more. Also, the [Examples][examples] directory has 
 a bunch of projects to explore to see more advanced usages.