feat(swift): support standard row format

.github/workflows/ci.yml

@@ -562,18 +562,19 @@ jobs:
             ~/.swiftpm
             ~/Library/Caches/org.swift.swiftpm
             swift/.build
-          key: ${{ runner.os }}-${{ runner.arch }}-swiftpm-xlang-release-${{ steps.swift-package-cache.outputs.toolchain }}-${{ hashFiles('swift/Package.resolved', 'swift/Package.swift', 'swift/Sources/**', 'swift/Tests/ForyXlangTests/**') }}
+          key: ${{ runner.os }}-${{ runner.arch }}-swiftpm-xlang-release-${{ steps.swift-package-cache.outputs.toolchain }}-${{ hashFiles('swift/Package.resolved', 'swift/Package.swift', 'swift/Sources/**', 'swift/Tests/ForyXlangTests/**', 'swift/Tests/ForyRowXlangPeer/**') }}
           restore-keys: |
             ${{ runner.os }}-${{ runner.arch }}-swiftpm-xlang-release-${{ steps.swift-package-cache.outputs.toolchain }}-
-      - name: Prebuild Swift xlang peer for cache reuse
+      - name: Prebuild Swift xlang peers for cache reuse
         run: |
           cd swift
-          if [[ "${{ steps.swift-build-cache.outputs.cache-hit }}" == "true" && -x .build/release/ForyXlangTests ]]; then
-            echo "Using cached Swift xlang peer at swift/.build/release/ForyXlangTests"
+          if [[ "${{ steps.swift-build-cache.outputs.cache-hit }}" == "true" && -x .build/release/ForyXlangTests && -x .build/release/ForyRowXlangPeer ]]; then
+            echo "Using cached Swift xlang peers at swift/.build/release/ForyXlangTests and swift/.build/release/ForyRowXlangPeer"
             echo "FORY_SWIFT_PEER_PREBUILT=1" >> "$GITHUB_ENV"
             exit 0
           fi
           swift build -c release --disable-automatic-resolution --product ForyXlangTests
+          swift build -c release --disable-automatic-resolution --product ForyRowXlangPeer
           echo "FORY_SWIFT_PEER_PREBUILT=1" >> "$GITHUB_ENV"
       - name: Run Swift Xlang Test
         env:
@@ -584,6 +585,8 @@ jobs:
           mvn -T16 --no-transfer-progress clean install -DskipTests -Dmaven.javadoc.skip=true -Dmaven.source.skip=true
           cd fory-core
           mvn -T16 --no-transfer-progress test -Dtest=org.apache.fory.xlang.SwiftXlangTest
+          cd ../fory-format
+          mvn -T16 --no-transfer-progress test -Dtest=org.apache.fory.format.SwiftCrossLanguageTest
 
   swift_idl:
     name: Swift IDL Tests

README.md

@@ -844,7 +844,8 @@ deserialization, see the [Java row-format guide](docs/row-format/java.md),
 [Python row-format guide](docs/row-format/python.md),
 [C++ row-format guide](docs/row-format/cpp.md),
 [Rust row-format guide](docs/row-format/rust.md),
-[Go row-format guide](docs/row-format/go.md), and
+[Go row-format guide](docs/row-format/go.md),
+[Swift row-format guide](docs/row-format/swift.md), and
 [row-format specification](docs/specification/row_format_spec.md).
 
 ## Fory JSON

docs/introduction/choose-a-format.md

@@ -19,12 +19,12 @@ license: |
   limitations under the License.
 ---
 
-| Format or mode | Data model                          | Use it when                                                   | Interoperability                                                            | Start here                                               |
-| -------------- | ----------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------- |
-| Xlang binary   | Portable object graphs              | Data crosses language boundaries                              | Shared wire format across supported Fory implementations                    | [Cross-language guide](../object-serialization/xlang.md) |
-| Native binary  | Language-native object graphs       | Producer and consumer use one Fory implementation family      | One Fory implementation family only                                         | [Object Serialization](../object-serialization/index.md) |
-| Row Format     | Random-access binary rows           | You need random field access or analytics-style partial reads | Standard Row is shared by Java, Python, C++, and Rust; Compact is Java-only | [Row Format guide](../row-format/index.md)               |
-| Fory JSON      | Standard JSON mapped to JVM objects | Java, Kotlin, or Scala applications need standard JSON        | Standard JSON text                                                          | [Fory JSON guide](../json/index.md)                      |
+| Format or mode | Data model                          | Use it when                                                   | Interoperability                                                                   | Start here                                               |
+| -------------- | ----------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------- |
+| Xlang binary   | Portable object graphs              | Data crosses language boundaries                              | Shared wire format across supported Fory implementations                           | [Cross-language guide](../object-serialization/xlang.md) |
+| Native binary  | Language-native object graphs       | Producer and consumer use one Fory implementation family      | One Fory implementation family only                                                | [Object Serialization](../object-serialization/index.md) |
+| Row Format     | Random-access binary rows           | You need random field access or analytics-style partial reads | Standard Row is shared by Java, Python, C++, Rust, and Swift; Compact is Java-only | [Row Format guide](../row-format/index.md)               |
+| Fory JSON      | Standard JSON mapped to JVM objects | Java, Kotlin, or Scala applications need standard JSON        | Standard JSON text                                                                 | [Fory JSON guide](../json/index.md)                      |
 
 Xlang and native are sibling modes of Object Serialization. Use them when the receiver needs to
 reconstruct an object graph. Row Format and Fory JSON are separate formats, not additional Object

docs/introduction/index.md

@@ -113,7 +113,7 @@ optimized for analytics and partial-read workloads:
 - **Zero-copy random access**: Read fields, arrays, and nested values without rebuilding whole objects.
 - **Partial operations**: Read only the values needed for a query or pipeline stage.
 - **Apache Arrow integration**: Convert to columnar data for analytics pipelines.
-- **Multi-language support**: Exchange Standard Row Format data across Java, Python, C++, and Rust.
+- **Multi-language support**: Exchange Standard Row Format data across Java, Python, C++, Rust, and Swift.
 
 ### Optimized Fory Implementations
 

docs/introduction/support-matrix.md

@@ -26,7 +26,7 @@ does not imply support for every Fory capability.
 | --------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------- |
 | Xlang object serialization  | Java, Python, C++, Go, Rust, JavaScript/TypeScript, C#, Swift, Dart, Scala, Kotlin | One shared xlang wire format                             |
 | Native object serialization | Java, Python, C++, Go, Rust, Scala, Kotlin                                         | One Fory implementation family only                      |
-| Standard Row Format         | Java, Python, C++, Rust                                                            | Shared Standard Row layout                               |
+| Standard Row Format         | Java, Python, C++, Rust, Swift                                                     | Shared Standard Row layout                               |
 | Compact Row Format          | Java                                                                               | Java-only compact layout                                 |
 | Fory JSON                   | Java, Kotlin, Scala                                                                | Standard JSON text                                       |
 | Fory compiler output        | Java, Python, C++, Go, Rust, JavaScript/TypeScript, C#, Swift, Dart, Scala, Kotlin | Generated models use supported Fory APIs                 |

docs/row-format/go.md

@@ -257,5 +257,5 @@ underlying bytes are not modified.
 ## Related Topics
 
 - [Basic Serialization](../object-serialization/go/basic-serialization.md) - Object graph serialization
-- [Standard Row Format](index.md#standard-row) - Shared layout for Java, Python, C++, Rust, and Go
+- [Standard Row Format](index.md#standard-row) - Shared layout for Java, Python, C++, Rust, Go, and Swift
 - [Row Format Specification](../specification/row_format_spec.md) - Protocol details

docs/row-format/index.md

@@ -30,20 +30,20 @@ reconstruction as its primary access pattern.
 
 ## Choose a Layout
 
-| Layout       | Language support            | Compatibility                    |
-| ------------ | --------------------------- | -------------------------------- |
-| Standard Row | Java, Python, C++, Rust, Go | Shared Standard Row layout       |
-| Compact Row  | Java                        | Java-only, space-oriented layout |
+| Layout       | Language support                   | Compatibility                    |
+| ------------ | ---------------------------------- | -------------------------------- |
+| Standard Row | Java, Python, C++, Rust, Go, Swift | Shared Standard Row layout       |
+| Compact Row  | Java                               | Java-only, space-oriented layout |
 
 ## Standard Row
 
-Standard Row is the interoperable layout for Java, Python, C++, Rust, and Go.
+Standard Row is the interoperable layout for Java, Python, C++, Rust, Go, and Swift.
 
 ### Features
 
 - **Zero-copy random access**: Read selected fields directly from encoded data.
 - **Partial deserialization**: Reconstruct only the values an application needs.
-- **Cross-language compatibility**: Share Standard Row bytes between Java, Python, C++, Rust, and Go.
+- **Cross-language compatibility**: Share Standard Row bytes between Java, Python, C++, Rust, Go, and Swift.
 - **Apache Arrow integration**: Convert rows to Arrow data in Java and Python.
 
 ### Layout
@@ -62,6 +62,7 @@ layout, alignment rules, type table, and endianness are defined by the
 | C++      | Compatible                 | [C++](cpp.md)       | Native row readers and writers                         |
 | Rust     | Compatible                 | [Rust](rust.md)     | Borrowed struct, array, and map views                  |
 | Go       | Compatible                 | [Go](go.md)         | Reflection struct encoder; zero-copy row views         |
+| Swift    | Compatible                 | [Swift](swift.md)   | Macro-generated struct encoder; zero-copy row views    |
 
 Use the language guides for installation, schema construction, encoding, random access, partial
 reads, and language-specific integrations.
@@ -94,7 +95,7 @@ Reuse the encoder within one thread. Create separate encoders for concurrent thr
 - Fixed-size nested structs can be stored inline.
 
 Choose Compact Row only when every reader is Java and the space reduction justifies the
-Java-specific layout. Use Standard Row for Java, Python, C++, Rust, and Go interchange.
+Java-specific layout. Use Standard Row for Java, Python, C++, Rust, Go, and Swift interchange.
 
 See the [Row Format specification](../specification/row_format_spec.md) for the exact Standard and
 Compact binary layouts.