Update to v3.2.1 (#2)

* Replace fatal errors in transitionDuration delegate methods (scenee#642)

This PR modifies the transitionDuration(using:) method in FloatingPanelController to return 0.0 instead of calling fatalError when the FloatingPanelController instance is not found. This change is crucial for several reasons:

1. Avoiding Crashes in Production: Using fatalError in production can lead to unexpected crashes, which are detrimental to user experience. It's safer to return a default value like 0.0 and handle the scenario gracefully.

2. Improved Stability: By returning 0.0, the application can continue running, allowing for better stability and user satisfaction. This approach also aligns with the principle of fail-safety, where the system continues operating under error conditions.

3. Real-World Case: In our large-scale project, we encountered a crash at this specific point due to the fatalError. Given the size and complexity of our application, it has been challenging to pinpoint the exact cause. Switching to a return value of 0.0 would significantly help us mitigate the issue and maintain app stability while we investigate further.

4. Maintainability: Returning a default value makes the codebase more maintainable and easier to debug, as it avoids abrupt termination and allows for logging or other error handling mechanisms.

* Version 2.8.5

* Fix doc comments' errors  (scenee#644)

* Fix doc comment errors in ObjC APIs
* Improve doc comments in LayoutAnchoring.swift

* Version 2.8.6

* Disallow interrupting the panel interaction while bouncing over the most expanded state (scenee#652)

I decided to disallow interrupting panel interactions while bouncing over the most expanded state in order to fix the 2nd issue in scenee#633, scenee#633 (comment).

* Reset `initialScrollOffset` after the attracting animation ends (scenee#659)

* Stop pinning the scroll offset in moving programmatically
* Add 'optional' string interpolation
* Add comments
* Add CoreTests.test_initial_scroll_offset_reset()
* ci: remove macos-12 jobs for the deprecation
* ci: name circleci jobs

* ci: use Xcode 16.2 (scenee#653)

* Added '--verbose' in cocoapods job
* Fixed 'error: No simulator runtime version'. Some of the example apps cannot be built on github actions.
> /Users/runner/work/FloatingPanel/FloatingPanel/Examples/Samples/Sources/Assets.xcassets: error: No simulator runtime version from [<DVTBuildVersion 21A342>, <DVTBuildVersion 21C62>, <DVTBuildVersion 21E213>, <DVTBuildVersion 21F79>, <DVTBuildVersion 22B81>] available to use with iphonesimulator SDK version <DVTBuildVersion 22C146>
* Used macos-15 to fix random build fails

* ci: use macos-15 for all testing to use Xcode 16.2

* Version 2.8.7

* Revert "Disallow interrupting the panel interaction while bouncing over the most expanded state (scenee#652)"

This reverts commit b0fd0d4.

This change had a problem normal cases. For example, in Maps example a
panel interaction jumps occurs because of this.

* Allow slight deviation when checking for anchor position.

This change addresses the 2nd issue reported in scenee#633. The previous attempt
in commit b0fd0d4 was intended to fix this, but it has a regression.
This change resolves the issue without introducing any regressions.

* Fix a miss spell

* Address scenee#661 issue since v2.8.0  (scenee#662)

See this comment for more details.
scenee#661 (comment)

* Version 2.8.8

* ci: add workflow_dispatch event trigger

* Update FloatingPanelController

* Dump the default config of swift-format on Xcode 16.3

* Lint the library code by built-in swift-format

* Ignore project.xcworkspace dir

* Update .swift-format

* Update the minimum deployment target to iOS 13

* Drop Xcode 13.4.1 support

The following errors occur only on Xcode 13.4.1. Addressing them would
significantly impair the usability of this library’s API. Therefore, I have
decided not to support Xcode 13.4.1.

> /.../FloatingPanel/Sources/SwiftUI/FloatingPanelView.swift:9:33: error: protocol 'FloatingPanelCoordinator' can only be used as a generic constraint because it has Self or associated type requirements
>     let coordinator: () -> (any FloatingPanelCoordinator)
>                                 ^
> /.../FloatingPanel/Sources/SwiftUI/FloatingPanelView.swift:78:42: error: protocol 'FloatingPanelCoordinator' can only be used as a generic constraint because it has Self or associated type requirements
>     public func makeCoordinator() -> any FloatingPanelCoordinator {
>                                          ^
> /.../FloatingPanel/Sources/SwiftUI/View+floatingPanel.swift:26:67: error: 'some' types are only implemented for the declared type of properties and subscripts and the return type of functions
>         @ViewBuilder _ content: @escaping (FloatingPanelProxy) -> some View
>                                                                   ^
> /.../FloatingPanel/Sources/SwiftUI/View+floatingPanel.swift:26:9: error: result builder attribute 'ViewBuilder' can only be applied to a parameter of function type
>         @ViewBuilder _ content: @escaping (FloatingPanelProxy) -> some View
>         ^
> /.../FloatingPanel/Sources/SwiftUI/View+floatingPanel.swift:24:31: error: default argument value of type 'FloatingPanelDefaultCoordinator.Type' cannot be converted to type 'T.Type'
>         coordinator: T.Type = FloatingPanelDefaultCoordinator.self,
>                               ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>                                                                    as! T.Type
> /.../FloatingPanel/Sources/SwiftUI/View+floatingPanel.swift:28:9: error: generic parameter 'ContentView' could not be inferred
>         FloatingPanelView(
>         ^
> /.../FloatingPanel/Sources/SwiftUI/FloatingPanelView.swift:8:49: note: 'ContentView' declared as parameter to type 'FloatingPanelView'
> public struct FloatingPanelView<MainView: View, ContentView: View>: UIViewControllerRepresentable {
>                                                 ^
> /.../FloatingPanel/Sources/SwiftUI/View+floatingPanel.swift:28:9: note: explicitly specify the generic arguments to fix this issue
>         FloatingPanelView(
>         ^
>                          <Self, <#ContentView: View#>>

* Expand timeout for some test cases in {Controller,Core}Tests

* Implement SwiftUI APIs based on the Maps-SwiftUI app

* Added SamplesSwiftUI
* Moved Maps-SwiftUI project in workspace
* Updated build tools
* Fixed xcode 15.1 build
* Added FloatingPanel.SurfaceAppearance.box()

* Polish source code of CoreTests a bit

* Take care of file paths including non-ASCII chars in SwiftFormatBuildToolPlugin

* Add .xcodesamplecode.plist

* Move 'assets' folder in 'Documentation' folder

* Update documentation for the new SwiftUI APIs

* Added 'FloatingPanel SwiftUI API Guide'
* Updated README

* ci: update example builds

* ci: fix swift 5.9 and 5.10 builds

* ci: use Xcode 16.3 and iOS 18.4

* Add CHANGELOG

* Version 3.0.0

* Modify the top page of the DocC

* Improve CoreTests a bit

* ci: fix the build environments

* Fix the pod spec for the SwiftUI APIs

* Version 3.0.1

* ci: remove builds using deprecated 'macos-13' machine

* Add support for UICornerConfiguration in iOS 26 (scenee#664)

* ci: add iOS 26 to test matrix

* Pass CoreTests.test_initial_scroll_offset_reset()

Since iOS 26, UIGestureRecognizer.state is not able to change even
if it's assigned a new value programmatically. Therefore, I created
MockPanGestureRecognizer to change the state property in testing.

* Fix a build error on Xcode 16

* Fix compilation conditions at c5291d7

* Enable to build it for iOS 12

* Add CoreTests.test_statePublisher

* ci: fix a job error

* Add 'Star History Chart' at the bottom of README

* Set minimum iOS version to v12

* Version 3.1.0

* Support dynamic content updates in SwiftUI

Store content hosting controller reference and update it dynamically
in updateUIViewController(), allowing panel content to change without
recreation.

Resolved scenee#672

* Improve SamplesSwiftUI

* ci: use Xcode 26.0.1 for all builds

* Fix shadow on iOS 26

* examples: fix animation glitch on iOS 26

* Version 3.2.0

* Remove badges from README

* ci: fix 'swiftpm' job

* Fix scroll offset reset due to floating-point precision errors (scenee#677)

When the panel is already at a boundary position, floating-point
precision errors on some devices (like iPhone 17 Pro Max) can cause
unexpected offset resets in the position calculation.

This commit addresses the layout issue where fractional values caused
incorrect position evaluation. Based on the initial fix and sample
project provided by @0x1306a94.

Co-authored-by: 0x1306a94 <onyxes_accent_0a@icloud.com>

* Perform view updates during scroll tracking (scenee#679)

When we enable floatingPanelScrollTracking on our view inside of the floating panel, some view updates are performed (i.e., SwiftUI views are being instantiated) but no rendering (i.e., body evaluations) occurs.

Example code:
```swift
content
    .floatingPanel(
        coordinator: ContentPanelCoordinator.self,
        onEvent: onEvent
    ) { proxy in
        panelContent
            .floatingPanelScrollTracking(proxy: proxy) // scroll tracking breaks view updates
    }
```

We tracked this down to the scroll tracking, and it seems that the performing of view updates inside of the ScrollViewRepresentable was missing.

This seems similar to scenee#675.

* Version 3.2.1

---------

Co-authored-by: Ivan Levin <100189059+LevinIvan@users.noreply.github.com>
Co-authored-by: Shin Yamamoto <shin@scenee.com>
Co-authored-by: Will Bishop <17292672+WillBishop@users.noreply.github.com>
Co-authored-by: 0x1306a94 <onyxes_accent_0a@icloud.com>
Co-authored-by: Sören Gade <gade.soeren@gmail.com>

Author: 6 people

.circleci/config.yml

@@ -1,13 +1,13 @@
 name: ci
 
-on: 
+on:
   push:
-    branches: 
+    branches:
       - master
-      - next
   pull_request:
-    branches: 
-      - '*'
+    branches:
+      - "*"
+  workflow_dispatch:
 
 jobs:
   build:
@@ -19,17 +19,11 @@ jobs:
       matrix:
         include:
           - swift: "5"
-            xcode: "16.2"
+            xcode: "16.4"
             runs-on: macos-15
           - swift: "5.10"
             xcode: "15.4"
             runs-on: macos-14
-          - swift: "5.9"
-            xcode: "15.2"
-            runs-on: macos-13
-          - swift: "5.8"
-            xcode: "14.3.1"
-            runs-on: macos-13
     steps:
       - uses: actions/checkout@v4
       - name: Building in Swift ${{ matrix.swift }}
@@ -43,36 +37,36 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: "18.2"
-            xcode: "16.2"
+          - os: "26.0.1"
+            xcode: "26.0.1"
             sim: "iPhone 16 Pro"
-            parallel: NO  # Stop random test job failures
+            parallel: NO # Stop random test job failures
+            runs-on: macos-15
+          - os: "18.5"
+            xcode: "16.4"
+            sim: "iPhone 16 Pro"
+            parallel: NO # Stop random test job failures
             runs-on: macos-15
           - os: "17.5"
             xcode: "15.4"
             sim: "iPhone 15 Pro"
-            parallel: NO  # Stop random test job failures
+            parallel: NO # Stop random test job failures
             runs-on: macos-14
-          - os: "16.4"
-            xcode: "14.3.1"
-            sim: "iPhone 14 Pro"
-            parallel: NO  # Stop random test job failures
-            runs-on: macos-13
     steps:
-    - uses: actions/checkout@v4
-    - name: Testing in iOS ${{ matrix.os }}
-      run: |
-        xcodebuild clean test \
-          -workspace FloatingPanel.xcworkspace \
-          -scheme FloatingPanel \
-          -destination 'platform=iOS Simulator,OS=${{ matrix.os }},name=${{ matrix.sim }}' \
-          -parallel-testing-enabled '${{ matrix.parallel }}'
+      - uses: actions/checkout@v4
+      - name: Testing in iOS ${{ matrix.os }}
+        run: |
+          xcodebuild clean test \
+            -workspace FloatingPanel.xcworkspace \
+            -scheme FloatingPanel \
+            -destination 'platform=iOS Simulator,OS=${{ matrix.os }},name=${{ matrix.sim }}' \
+            -parallel-testing-enabled '${{ matrix.parallel }}'
     timeout-minutes: 20
 
   example:
     runs-on: macos-15
     env:
-      DEVELOPER_DIR: /Applications/Xcode_16.2.app/Contents/Developer
+      DEVELOPER_DIR: /Applications/Xcode_26.0.1.app/Contents/Developer
     strategy:
       fail-fast: false
       matrix:
@@ -81,82 +75,73 @@ jobs:
           - example: "Maps-SwiftUI"
           - example: "Stocks"
           - example: "Samples"
+          - example: "SamplesObjC"
+          - example: "SamplesSwiftUI"
     steps:
-    - uses: actions/checkout@v4
-    - name: Building ${{ matrix.example }}
-      # Need to use iphonesimulator18.1 because randomly 18.2<DVTBuildVersion 22C146> isn't available.
-      run: |
-        xcodebuild clean build \
-          -workspace FloatingPanel.xcworkspace \
-          -scheme ${{ matrix.example }} \
-          -sdk iphonesimulator
+      - uses: actions/checkout@v4
+      - name: Building ${{ matrix.example }}
+        run: |
+          xcodebuild clean build \
+            -workspace FloatingPanel.xcworkspace \
+            -scheme ${{ matrix.example }} \
+            -sdk iphonesimulator
 
   swiftpm:
-    runs-on: macos-15
+    runs-on: ${{ matrix.runs-on }}
     env:
       DEVELOPER_DIR: /Applications/Xcode_${{ matrix.xcode }}.app/Contents/Developer
     strategy:
       fail-fast: false
       matrix:
-        xcode: ["16.2", "15.4"]
+        xcode: ["26.0.1", "16.4", "15.4"]
         platform: [iphoneos, iphonesimulator]
         arch: [x86_64, arm64]
         exclude:
           - platform: iphoneos
             arch: x86_64
         include:
-          # 18.2
+          # 26.0.1
           - platform: iphoneos
-            xcode: "16.2"
-            sys: "ios18.2"
+            xcode: "26.0.1"
+            sys: "ios26.0"
+            runs-on: macos-15
           - platform: iphonesimulator
-            xcode: "16.2"
-            sys: "ios18.2-simulator"
+            xcode: "26.0.1"
+            sys: "ios26.0-simulator"
+            runs-on: macos-15
+          # 18.5
+          - platform: iphoneos
+            xcode: "16.4"
+            sys: "ios18.5"
+            runs-on: macos-15
+          - platform: iphonesimulator
+            xcode: "16.4"
+            sys: "ios18.5-simulator"
+            runs-on: macos-15
           # 17.2
           - platform: iphoneos
             xcode: "15.4"
             sys: "ios17.2"
+            runs-on: macos-14
           - platform: iphonesimulator
             xcode: "15.4"
             sys: "ios17.2-simulator"
+            runs-on: macos-14
     steps:
-    - uses: actions/checkout@v4
-    - name: "Swift Package Manager build"
-      run: |
-        xcrun swift build \
-          --sdk "$(xcrun --sdk ${{ matrix.platform }} --show-sdk-path)" \
-          -Xswiftc "-target" -Xswiftc "${{ matrix.arch }}-apple-${{ matrix.sys }}"
-
-  swiftpm_old:
-    runs-on: ${{ matrix.runs-on }}
-    env:
-      DEVELOPER_DIR: /Applications/Xcode_${{ matrix.xcode }}.app/Contents/Developer
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          # 16.4
-          - target: "x86_64-apple-ios16.4-simulator"
-            xcode: "14.3.1"
-            runs-on: macos-13
-          - target: "arm64-apple-ios16.4-simulator"
-            xcode: "14.3.1"
-            runs-on: macos-13
-    steps:
-    - uses: actions/checkout@v4
-    - name: "Swift Package Manager build"
-      run: |
-        swift build \
-          -Xswiftc "-sdk" -Xswiftc "`xcrun --sdk iphonesimulator --show-sdk-path`" \
-          -Xswiftc "-target" -Xswiftc "${{ matrix.target }}"
+      - uses: actions/checkout@v4
+      - name: "Swift Package Manager build"
+        run: |
+          xcrun swift build \
+            --sdk "$(xcrun --sdk ${{ matrix.platform }} --show-sdk-path)" \
+            -Xswiftc "-target" -Xswiftc "${{ matrix.arch }}-apple-${{ matrix.sys }}"
 
   cocoapods:
     runs-on: macos-15
     env:
-      DEVELOPER_DIR: /Applications/Xcode_16.2.app/Contents/Developer
+      DEVELOPER_DIR: /Applications/Xcode_26.0.1.app/Contents/Developer
     steps:
-    - uses: actions/checkout@v4
-    - name: "CocoaPods: pod lib lint"
-      run: pod lib lint --allow-warnings --verbose
-    - name: "CocoaPods: pod spec lint"
-      run: pod spec lint --allow-warnings --verbose
+      - uses: actions/checkout@v4
+      - name: "CocoaPods: pod lib lint"
+        run: pod lib lint --allow-warnings --verbose
+      - name: "CocoaPods: pod spec lint"
+        run: pod spec lint --allow-warnings --verbose

.github/workflows/ci.yml

@@ -18,6 +18,7 @@ DerivedData/
 !default.perspectivev3
 xcuserdata/
 IDEWorkspaceChecks.plis
+*.xcodeproj/project.xcworkspace
 
 ## Other
 *.moved-aside

.gitignore

@@ -0,0 +1,79 @@
+{
+  "fileScopedDeclarationPrivacy" : {
+    "accessLevel" : "private"
+  },
+  "indentConditionalCompilationBlocks" : false,
+  "indentSwitchCaseLabels" : false,
+  "indentation" : {
+    "spaces" : 4
+  },
+  "lineBreakAroundMultilineExpressionChainComponents" : false,
+  "lineBreakBeforeControlFlowKeywords" : false,
+  "lineBreakBeforeEachArgument" : false,
+  "lineBreakBeforeEachGenericRequirement" : false,
+  "lineBreakBetweenDeclarationAttributes" : false,
+  "lineLength" : 120,
+  "maximumBlankLines" : 1,
+  "multiElementCollectionTrailingCommas" : true,
+  "noAssignmentInExpressions" : {
+    "allowedFunctions" : [
+      "XCTAssertNoThrow"
+    ]
+  },
+  "prioritizeKeepingFunctionOutputTogether" : false,
+  "reflowMultilineStringLiterals" : {
+    "never" : {
+
+    }
+  },
+  "respectsExistingLineBreaks" : true,
+  "rules" : {
+    "AllPublicDeclarationsHaveDocumentation" : false,
+    "AlwaysUseLiteralForEmptyCollectionInit" : false,
+    "AlwaysUseLowerCamelCase" : true,
+    "AmbiguousTrailingClosureOverload" : true,
+    "AvoidRetroactiveConformances" : true,
+    "BeginDocumentationCommentWithOneLineSummary" : false,
+    "DoNotUseSemicolons" : true,
+    "DontRepeatTypeInStaticProperties" : true,
+    "FileScopedDeclarationPrivacy" : true,
+    "FullyIndirectEnum" : true,
+    "GroupNumericLiterals" : true,
+    "IdentifiersMustBeASCII" : true,
+    "NeverForceUnwrap" : false,
+    "NeverUseForceTry" : false,
+    "NeverUseImplicitlyUnwrappedOptionals" : false,
+    "NoAccessLevelOnExtensionDeclaration" : true,
+    "NoAssignmentInExpressions" : true,
+    "NoBlockComments" : true,
+    "NoCasesWithOnlyFallthrough" : true,
+    "NoEmptyLinesOpeningClosingBraces" : false,
+    "NoEmptyTrailingClosureParentheses" : true,
+    "NoLabelsInCasePatterns" : true,
+    "NoLeadingUnderscores" : false,
+    "NoParensAroundConditions" : true,
+    "NoPlaygroundLiterals" : true,
+    "NoVoidReturnOnFunctionSignature" : true,
+    "OmitExplicitReturns" : false,
+    "OneCasePerLine" : true,
+    "OneVariableDeclarationPerLine" : true,
+    "OnlyOneTrailingClosureArgument" : true,
+    "OrderedImports" : true,
+    "ReplaceForEachWithForLoop" : true,
+    "ReturnVoidInsteadOfEmptyTuple" : true,
+    "TypeNamesShouldBeCapitalized" : true,
+    "UseEarlyExits" : false,
+    "UseExplicitNilCheckInConditions" : true,
+    "UseLetInEveryBoundCaseVariable" : true,
+    "UseShorthandTypeNames" : true,
+    "UseSingleLinePropertyGetter" : true,
+    "UseSynthesizedInitializer" : true,
+    "UseTripleSlashForDocumentationComments" : true,
+    "UseWhereClausesInForLoops" : false,
+    "ValidateDocumentationComments" : false
+  },
+  "spacesAroundRangeFormationOperators" : false,
+  "spacesBeforeEndOfLineComments" : 2,
+  "tabWidth" : 8,
+  "version" : 1
+}

.swift-format

@@ -0,0 +1,9 @@
+.DS_Store
+/.build
+/Packages
+xcuserdata/
+DerivedData/
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc
+

BuildTools/.gitignore

@@ -0,0 +1,19 @@
+// swift-tools-version: 6.0
+
+import PackageDescription
+
+let package = Package(
+    name: "build-tools",
+    products: [
+        .plugin(
+            name: "swift-format-plugin",
+            targets: ["swift-format-plugin"]
+        )
+    ],
+    targets: [
+        .plugin(
+            name: "swift-format-plugin",
+            capability: .buildTool()
+        )
+    ]
+)

BuildTools/Package.swift

@@ -0,0 +1,20 @@
+// swift-tools-version: 5.9
+// This file is used when the 'built-tools' package is built by Xcode 15 or earlier.
+
+import PackageDescription
+
+let package = Package(
+    name: "build-tools",
+    products: [
+        .plugin(
+            name: "swift-format-plugin",
+            targets: ["swift-format-plugin"]
+        )
+    ],
+    targets: [
+        .plugin(
+            name: "swift-format-plugin",
+            capability: .buildTool()
+        )
+    ]
+)