Merge branch 'main' into json-association

Author: stephencelis

Sources/StructuredQueriesCore/CaseExpression.swift

@@ -97,6 +97,23 @@ public struct Cases<Base, QueryValue: _OptionalProtocol>: QueryExpression {
     return cases
   }
 
+  /// Adds a `WHEN` clause to a `CASE` expression.
+  ///
+  /// - Parameters:
+  ///   - condition: A condition to test.
+  ///   - expression: A return value should the condition pass.
+  /// - Returns: A `CASE` expression builder.
+  public func when(
+    _ condition: some QueryExpression<Base>,
+    then expression: some QueryExpression<QueryValue.Wrapped>
+  ) -> Cases {
+    var cases = self
+    cases.cases.append(
+      When(predicate: condition.queryFragment, expression: expression.queryFragment).queryFragment
+    )
+    return cases
+  }
+
   /// Terminates a `CASE` expression with an `ELSE` clause.
   ///
   /// - Parameter expression: A return value should every `WHEN` condition fail.

Sources/StructuredQueriesCore/Documentation.docc/Articles/PrimaryKeyedTables.md

@@ -61,7 +61,8 @@ into the database by providing only a draft:
 @Row {
   @Column {
     ```swift
-    Reminder.insert(Reminder.Draft(title: "Get groceries"))
+    Reminder
+      .insert(Reminder.Draft(title: "Get groceries"))
     ```
   }
   @Column {
@@ -122,8 +123,6 @@ Or even get back the entire newly inserted row:
     ```
   }
 }
-```swift
-```
 
 At times your application may want to provide the same business logic for creating a new record and
 editing an existing one. Your primary keyed table's `Draft` type can be used for these kinds of