mustiikhalil

This commit primarily introduces a significant **performance optimization** by **refactoring** the **FlexBuffersWriter** in Swift. It transitions the **internal stack implementation** from a native array to a custom pointer-based `Stack` struct within `FlexBuffersWriter.swift`, updating all related operations for improved efficiency during FlexBuffers serialization. This change aims to enhance the overall performance of the **FlexBuffers** writing process. Additionally, it includes a **fix** for an issue in the `_InternalByteBuffer.swift` reallocation logic and adds an endianness assertion to the `getRoot` function in `Reference.swift`.

This commit **fixes a build issue** within the **Swift FlatBuffers library** by updating the `swift/BUILD.bazel` configuration. Specifically, it ensures that Swift source files located in the `Sources/FlatBuffers/Vectors` directory are correctly included in the `swift` library target. This **build fix** resolves a critical problem where the Bazel build system was unable to locate these essential vector-related components. The change is crucial for the **successful compilation of the Swift library**, particularly for version 8.5.0, by enabling proper dependency resolution during the build process.

This commit **adds comprehensive test coverage** for **FlexBuffers** functionality within the **WebAssembly (Wasm)** environment, specifically for Swift. It introduces new tests for JSON encoding/decoding, reader operations including buffer validation, Unicode string handling, and extensive writer functionality covering various data types, vectors, and maps. This **test enhancement** ensures the robustness and correctness of FlexBuffers serialization and deserialization when used in Wasm applications, validating its behavior across different data structures and scenarios.

This commit **migrates** the project's **WebAssembly (Wasm) build and test infrastructure** to leverage the native Swift SDK for Wasm. As a **maintenance chore**, it updates the `.github/workflows/build.yml` to use new setup actions and test commands tailored for the native SDK. Concurrently, the Swift version for Wasm tests is upgraded to `6.2.1` in `tests/swift/Wasm.tests/.swift-version`, and the `carton` dependency is replaced with `WasmKit` in `tests/swift/Wasm.tests/Package.swift`. This change modernizes the Wasm compilation and execution environment, ensuring compatibility with the latest Swift Wasm tooling.

This commit **reverts** the **Swift build workflow** in `.github/workflows/build.yml` to once again use `swift-actions/setup-swift@v2` within the **GitHub Actions CI/CD pipeline**. This **maintenance chore** addresses a previous technical blocker, as `swift-actions` has now resolved an issue related to GPG keys that previously necessitated its removal. The change specifically impacts the **Linux build environment setup** and also simplifies the test command for these builds. This re-adoption of `swift-actions` is expected to improve the overall reliability and stability of Swift CI builds.

This commit introduces **native support for inline arrays** within Flatbuffers Structs in Swift, significantly enhancing the **Swift code generator** to produce more efficient and idiomatic code. It provides a new `FlatbufferVectors` API for mutable structs and **refactors** generated object API methods to leverage `borrowing` parameters, eliminating `inout` and `mutating` keywords for improved performance and concurrency safety. This **new capability** also includes a **bug fix** for mutations within fixed-size arrays. The changes impact the **Swift Flatbuffers runtime and generated models**, with comprehensive new tests validating the functionality.

This commit **raises the minimum supported Swift version for the FlatBuffers library to 5.10**, representing a significant **maintenance update** and **tooling upgrade**. It updates various **build and dependency management configurations**, including `.bazelci/presubmit.yml`, `.github/workflows/build.yml`, `FlatBuffers.podspec`, and all `Package.swift` manifests, to enforce this new baseline. Furthermore, the **Swift FlatBuffers source code** undergoes minor **refactoring** by removing conditional compilation for functions like `createVector` and `push` in `FlatBufferBuilder.swift` and `_InternalByteBuffer.swift`, as these are now universally supported. This ensures the project leverages modern Swift features and streamlines the codebase, requiring all consumers of the **Swift FlatBuffers library** to use Swift 5.10 or newer.

This commit **updates the documentation** to accurately reflect expanded support for **Swift features**. Specifically, the `docs/source/support.md` file now indicates that Swift officially supports the **Buffer verifier**, **Native Object API**, **Flexbuffers**, and **Platform: Windows**. This **documentation update** ensures that users consulting the support matrix have the most current information regarding Swift's capabilities within the project.

This commit **improves the performance of string serialization** within the **Swift FlatBuffers library** by **refactoring** its internal string handling mechanisms. It updates the `FlatBufferBuilder.swift` to use `withCString` and a new `writeBytes` method in `_InternalByteBuffer.swift` for string writing, specifically within the `finish` and `create` methods. This change replaces less efficient `push` methods, enabling more direct and efficient raw pointer copying of string data into the buffer. The optimization leads to faster and more efficient FlatBuffer construction when dealing with string fields in Swift.

This commit **fixes failing tests** within the **Swift Flatbuffers test suite** on **macOS**, specifically addressing issues with file path construction and data loading. It resolves a **bug** where `URL(fileURLWithPath:isDirectory:)` was incorrectly used instead of `URL(string:)` in the `testReadFromOtherLanguages` function, which caused failures on the macOS platform. This ensures the **reliability of Flatbuffers tests** and improves **cross-platform compatibility validation** for data serialization. Additionally, a minor **refactoring** removes an unused `path` computed property from `tests/swift/Tests/Flatbuffers/FlatBuffersMonsterWriterTests.swift`.

This commit **reverts** a previous change, specifically restoring the project to align with the **latest state from the `swiftly ci` pipeline**. This **maintenance** action addresses a prior deviation, ensuring that the **Continuous Integration (CI) configuration** and related build processes are consistent with the intended `swiftly ci` baseline. The rollback effectively undoes a previous modification, bringing the codebase back into sync with the expected CI environment.

This commit **fixes** the **Swift Windows CI pipeline** by resolving a critical build failure on **GitHub Actions**. It **enables** the previously failing Swift Windows CI job in `.github/workflows/build.yml` by explicitly adding a necessary Visual Studio component to the setup. This **maintenance fix** ensures the continuous integration process for Swift on Windows can now execute successfully, serving as a **temporary workaround** until a permanent resolution is provided by `swiftlylab`. The change significantly improves the reliability of **CI/CD for Swift builds** on the Windows platform.

This commit **fixes a critical bug** in the **Swift FlatBuffers library** that caused crashes due to **misaligned pointer access** during vtable deduplication. The `endTable` function within `FlatBufferBuilder.swift` was corrected to read vtable lengths directly from the buffer, thereby resolving the memory alignment issue. This **enhances the stability and correctness** of FlatBuffers serialization for Swift applications by preventing runtime crashes. A new test case in `FlatBuffersTests.swift` has been added to reproduce and verify the fix.

This commit **refactors** the **Swift FlatBuffers** and **FlexBuffers** libraries by moving the `capacity` property and its management directly into the `ByteBuffer` and `_InternalByteBuffer` structs. This change streamlines core **buffer management** and **memory allocation** logic by removing the indirection of a separate `Storage` helper. Additionally, it introduces **overflow-safe arithmetic operators** (`&+`, `&-`, etc.) across numerous calculation-intensive methods in modules like `Mutable`, `Struct`, and `Table`, enhancing the **robustness** and **safety** of index and offset computations. This significant internal **refactoring** improves the overall reliability of data processing within the libraries and required updates to related test cases.

This commit delivers a **memory usage fix** and **refactoring** for the **Swift FlatBuffers and FlexBuffers libraries**, enabling a complete reset of the underlying memory for `_InternalByteBuffer` instances. The `FlatBufferBuilder`'s `clear` method and `FlexBuffersWriter`'s `reset` method are enhanced with a `keepingCapacity` option, allowing callers to choose whether to retain allocated memory or fully deallocate it. This **improves memory management** by providing more control over buffer reuse and reducing potential memory leaks or excessive allocations, particularly for `VTableStorage` and `_InternalByteBuffer` by removing `unowned` logic. New tests validate the reset functionality across both builders, ensuring more efficient resource handling.

This commit performs a significant **refactoring** of the **Swift module import strategy** for the `Common` module within the FlatBuffers and FlexBuffers libraries. It **removes the `@_exported` import** of `Common` from core `Constants.swift` files, instead opting for **explicit and conditional imports** of `Common` in all Swift source files that directly utilize its functionality. The **Swift code generator** (`idl_gen_swift.cpp`) has been updated to emit these conditional `import Common` statements into **generated FlatBuffers and FlexBuffers code**, and also applies `@_implementationOnly` to `FlatBuffers` imports for better encapsulation. This **maintenance** change improves **module encapsulation** by preventing `Common` types from being implicitly re-exported, ensuring that downstream consumers only link against modules they explicitly import. This enhances the overall dependency graph and potentially improves build performance of the Swift components.

This commit performs a **CI infrastructure update** by modifying the **GitHub Actions workflow** in `.github/workflows/build.yml`. It migrates the Swift build environment to use **Windows Server 2022** and **Visual Studio 2022**. Furthermore, this **maintenance** work switches the Swift setup action to `vapor/swiftly-action` (or `swift-actions@next`), ensuring the **CI pipeline** leverages the latest tooling for Swift builds. This update aims to keep the build system current and robust, particularly for **Swift projects** on Windows.

This commit **introduces Swift support for Windows**, enabling the FlatBuffers Swift library to be built and tested on the Windows platform. It achieves this by **refactoring** the main `Package.swift` to conditionally include GRPC dependencies and consolidate test targets, while also modifying the **GRPC code generator** (`grpc/src/compiler/swift_generator.cc`) to add conditional compilation directives that exclude GRPC-specific code on Windows. Furthermore, it updates the **CI/CD pipeline** (`.github/workflows/build.yml`) to include dedicated Windows Swift builds and adjusts test infrastructure to accommodate the new platform. This work represents a **new capability** that significantly expands the platform compatibility for Swift FlatBuffers, particularly for projects that need to manage GRPC components across different operating systems.

This commit introduces the **official native Swift port for FlexBuffers**, providing a significant **new capability** for Swift developers to efficiently serialize and deserialize data using this flexible buffer format. It delivers comprehensive **writing functionality** for various data types, including maps, vectors, and scalars, alongside robust **reading capabilities** for most FlexBuffers features like typed and fixed-typed vectors. A new **`Common` module** was established to centralize and share utilities such as `Scalar` and `padding` between both the new `FlexBuffers` and existing `FlatBuffers` implementations, enhancing code reuse and maintainability. This extensive work includes comprehensive tests to validate compatibility and correctness with the C++ FlexBuffers implementation.

This commit introduces a **major refactoring** and **new capabilities** to the **Swift FlatBuffers library** to significantly improve **memory efficiency** and **safety**. It implements a new internal `_InternalByteBuffer` and a public `ByteBuffer` API, enabling **zero-copy data handling** by retaining references to data created within the Swift library. This impacts the **FlatBufferBuilder**, **Table**, and **Message** components, enhancing **performance** and memory management. Furthermore, **memory safety** is improved by replacing `assumingMemoryBinding` with `bindMemory` in code generation and adding new `withUnsafeBufferPointer` methods for direct, safer access to scalar and vector data. The changes also include updates to use overflow-safe arithmetic operators and comprehensive test coverage.