Merge remote-tracking branch 'origin/main' into kve/display-hooks-for-headerfooters

* origin/main:
  build: set up tuist (#584)
  Bumping versions to 16.3.0 (#589)
  Reset scroll position if list identifier changes (#588)
  Bumping versions to 16.2.0 (#587)
  Adding a completion handler to the `scrollToSection` API. (#585)
  Adding a programmatic scroll completion handler (#582)
  Remove iOS 19 (26) cap of the collection view first responder workaround (#581)
  Bumping versions to 16.1.0 (#583)
  Update for Blueprint 6.0.0 (#580)
  Bumping versions to 16.0.4. (#579)
  Update the first responder resignation workaround to be enabled by default and cap at < iOS 19 [UI-8849] (#578)
  Bumping versions to 16.0.3 (#577)
  Bottom gravity and autoscroll improvements (#576)
  Bumping versions to 16.0.2 (#574)
  Addressing an AutoScrollAction issue when using VerticalLayoutGravity.bottom (#572)
  release: Prepare 16.0.1 release (#569)
  Fix reordering crash introduced in 16.0 (#568)

Author: Kyle Van Essen

.github/workflows/env.properties

@@ -1 +1,3 @@
 xcode_version=16.2
+TUIST_TEST_DEVICE=iPhone SE (3rd generation)
+TUIST_TEST_PLATFORM=iOS

.github/workflows/run_tests.yml

@@ -5,102 +5,70 @@
 name: Tests
 
 on:
+  push:
+    branches:
+      - main
   pull_request:
 
 jobs:
   spm:
-    name: Swift Package Manager
-
-    runs-on: macos-15-xlarge
-
-    steps:
-    
-      - name: Checkout repository
-        uses: actions/checkout@v1
-
-      - name: Read env
-        run: cat .github/workflows/env.properties >> $GITHUB_ENV
-        
-      - name: Switch to Xcode ${{ env.xcode_version }}
-        run: sudo xcode-select -s /Applications/Xcode_${{ env.xcode_version }}.app
-
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          # Uses version specified in .ruby_version
-          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-
-      - name: Install xcodes
-        run: brew install aria2 xcodesorg/made/xcodes
-
-      - name: Install iOS 17.2
-        run: sudo xcodes runtimes install "iOS 17.2"
-
-      # Build
-
-      - name: Build
-        run: xcodebuild -scheme "Listable-Package" -destination "platform=iOS Simulator,OS=17.2,name=iPhone SE (3rd generation)" -sdk iphonesimulator build
-
-  test:
-    name: "iOS ${{ matrix.sdk }}"
+    name: "Build & Test All - iOS ${{ matrix.sdk }}"
 
     runs-on: macos-15-xlarge
 
     strategy:
+      fail-fast: false # Don’t fail-fast so that we get all snapshot test changes
       matrix:
         include:
           - sdk: "15.4"
-            simulator_name: iPhone SE (3rd generation)
+            simctl_runtime: "com.apple.CoreSimulator.SimRuntime.iOS-15-4"
             installation_required: true
 
           - sdk: "16.2"
-            simulator_name: iPhone SE (3rd generation)
+            simctl_runtime: "com.apple.CoreSimulator.SimRuntime.iOS-16-2"
             installation_required: true
 
           - sdk: "17.2"
-            simulator_name: iPhone SE (3rd generation)
+            simctl_runtime: "com.apple.CoreSimulator.SimRuntime.iOS-17-2"
             installation_required: true
 
     steps:
 
       - name: Checkout repository
-        uses: actions/checkout@v1
+        uses: actions/checkout@v4
+
+      - name: Set up Mise
+        uses: jdx/mise-action@v2
 
       - name: Read env
         run: cat .github/workflows/env.properties >> $GITHUB_ENV
 
       - name: Switch to Xcode ${{ env.xcode_version }}
         run: sudo xcode-select -s /Applications/Xcode_${{ env.xcode_version }}.app
 
-      - name: Setup Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          # Uses version specified in .ruby_version
-          bundler-cache: true # runs 'bundle install' and caches installed gems automatically
-
       - name: Install xcodes
-        if: ${{ matrix.installation_required }}
         run: brew install aria2 xcodesorg/made/xcodes
 
       - name: Install iOS ${{ matrix.sdk }}
         if: ${{ matrix.installation_required }}
         run: sudo xcodes runtimes install "iOS ${{ matrix.sdk }}"
 
-      # Build Caching
-
-      - name: Cache Cocoapods
-        uses: actions/cache@v4
-        with:
-          path: Pods
-          key: ${{ runner.os }}-pods-${{ hashFiles('**/Podfile.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-pods-
+      - name: Build
+        run: |
+          xcodebuild \
+            -scheme "Listable-Package" \
+            -destination "platform=${{ env.TUIST_TEST_PLATFORM }} Simulator,OS=${{ matrix.sdk }},name=${{ env.TUIST_TEST_DEVICE }}" \
+            -sdk iphonesimulator build
 
-      # Install & Build
+      - name: Install Tuist dependencies for Development
+        run: tuist install --path Development/
 
-      - name: Pod Install
-        run: bundle exec pod install --repo-update
+      - name: Test All
+        run: tuist test ListableDevelopment-Workspace --path Development/ --os ${{ matrix.sdk }} --result-bundle-path TestResult.xcresult
 
-      - name: Build & Test
-        run: |
-          xcodebuild -workspace Demo/Demo.xcworkspace -scheme "Demo" -destination "platform=iOS Simulator,OS=${{ matrix.sdk }},name=${{ matrix.simulator_name }}" build test
+      - name: Upload TestResult
+        uses: actions/upload-artifact@v4
+        if: ${{ failure() }}
+        with:
+          name: TestResult.xcresult
+          path: TestResult.xcresult

.gitignore

@@ -40,16 +40,6 @@ playground.xcworkspace
 # Package.resolved
 .build/
 
-# CocoaPods
-#
-# We recommend against adding the Pods directory to your .gitignore. However
-# you should judge for yourself, the pros and cons are mentioned at:
-# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
-#
-Demo/Demo.xcworkspace
-Pods/
-gen/
-
 # Carthage
 #
 # Add this line if you want to avoid checking in source code from Carthage dependencies.
@@ -68,3 +58,14 @@ fastlane/report.xml
 fastlane/Preview.html
 fastlane/screenshots/**/*.png
 fastlane/test_output
+
+# Tuist
+/Derived
+/*.xcodeproj
+/*.xcworkspace
+/Development/Derived
+/Development/*.xcodeproj
+/Development/*.xcworkspace
+
+# Test results
+/*.xcresult

.mise.toml

@@ -0,0 +1,7 @@
+[tools]
+tuist = "4.23.0"
+swiftformat = "0.50.8"
+
+[settings]
+# do not try to read versions from .nvmrc, .ruby-version, etc.
+legacy_version_file = false

BlueprintUILists.podspec

@@ -190,28 +190,8 @@ extension List {
                 case .fillParent:
                     if let max = constraint.width.constrainedValue {
                         return max
-                    } else if case .caffeinated = layoutMode {
-                        return .infinity
                     } else {
-                        fatalError(
-                            """
-                            `List` is being used with the `.fillParent` measurement option, which takes \
-                            up the full width it is afforded by its parent element. However, \
-                            the parent element provided the `List` an unconstrained width, which is meaningless.
-                            
-                            How do you fix this?
-                            --------------------
-                            1) This usually means that your `List` itself has been \
-                            placed in a `ScrollView` or other element which intentionally provides an \
-                            unconstrained measurement to its content. If your `List` is in a `ScrollView`, \
-                            remove the outer scroll view – `List` manages its own scrolling. Two `ScrollViews` \
-                            that are nested within each other is generally meaningless unless they scroll \
-                            in different directions (eg, horizontal vs vertical).
-                            
-                            2) If your `List` is not in a `ScrollView`, ensure that the element
-                            measuring it is providing a constrained `SizeConstraint`.
-                            """
-                        )
+                        return .infinity
                     }
                 case .natural:
                     return size.naturalWidth ?? size.contentSize.width
@@ -223,31 +203,11 @@ extension List {
                 case .fillParent:
                     if let max = constraint.height.constrainedValue {
                         return max
-                    } else if case .caffeinated = layoutMode {
-                        return .infinity
                     } else {
-                        fatalError(
-                            """
-                            `List` is being used with the `.fillParent` measurement option, which takes \
-                            up the full height it is afforded by its parent element. However, \
-                            the parent element provided the `List` an unconstrained height, which is meaningless.
-                            
-                            How do you fix this?
-                            --------------------
-                            1) This usually means that your `List` itself has been \
-                            placed in a `ScrollView` or other element which intentionally provides an \
-                            unconstrained measurement to its content. If your `List` is in a `ScrollView`, \
-                            remove the outer scroll view – `List` manages its own scrolling. Two `ScrollViews` \
-                            that are nested within each other is generally meaningless unless they scroll \
-                            in different directions (eg, horizontal vs vertical).
-                            
-                            2) If your `List` is not in a `ScrollView`, ensure that the element
-                            measuring it is providing a constrained `SizeConstraint`.
-                            """
-                        )
+                        return .infinity
                     }
                 case .natural:
-                    if case .caffeinated = layoutMode, let maxHeight = constraint.height.constrainedValue {
+                    if let maxHeight = constraint.height.constrainedValue {
                         return min(size.contentSize.height, maxHeight)
                     }
                     return size.contentSize.height

BlueprintUILists/Resources/.gitkeep

@@ -14,8 +14,67 @@
 
 ### Internal
 
+- CocoaPods has been removed and local development environment is now driven by Tuist.
+
 # Past Releases
 
+# [16.3.0] - 2025-07-17
+
+### Changed
+
+- Changing a List's `identifier` now automatically resets the scroll position.
+
+# [16.2.0] - 2025-07-02
+
+### Added
+
+- Added a completion handler to ListView's `scrollTo(item:position:animated:completion:)` and `scrollToSection(with:sectionPosition:scrollPosition:animated:completion:)` APIs.
+
+### Misc
+
+- The `IOS16_4_First_Responder_Bug_CollectionView` workaround is no longer capped to iOS versions less than 19.0. It was verified as required in the iOS 19 beta.
+
+### Internal
+
+- Added the `ScrollCompletionHandlerViewController` demo to showcase the new completion handlers with different layout configurations.
+
+# [16.1.0] - 2025-06-17
+
+### Changed
+
+- Blueprint dependency updated to 6.0.
+
+# [16.0.4] - 2025-06-06
+
+### Misc
+
+- The `IOS16_4_First_Responder_Bug_CollectionView` workaround has been capped to OS versions _less_ than iOS 19.0 until the fix has been verified as required and functioning.
+- The interpretation of the `Listable.EnableIOS164FirstResponderWorkaround` user defaults flag now defaults to `true` if no value has been set.
+
+# [16.0.3] - 2025-05-20
+
+### Internal
+
+- Improving how `AutoScrollAction` and `VerticalLayoutGravity.bottom` work together by temporarily ignoring the bottom gravity logic while autoscrolling.
+
+# [16.0.2] - 2025-05-09
+
+### Fixed
+
+- Fixed an issue with `AutoScrollAction.OnInsertedItem` and `AutoScrollAction.Pin` that caused the scrolled offset to be reset to the bottom when using `VerticalLayoutGravity.bottom`.
+- Fixed issue with the `didPerform` closures of `AutoScrollAction.OnInsertedItem` and `AutoScrollAction.Pin`, where the visible items were stale after adjusting the offset with no animation.
+
+### Internal
+
+- Adding new demos to showcase mixing `AutoScrollAction.OnInsertedItem` and `AutoScrollAction.Pin` with `VerticalLayoutGravity.bottom`.
+- Adding a new `AutoScrollAction.Behavior` protocol.
+
+# [16.0.1] - 2025-04-16
+
+### Fixed
+
+- Fixed a crash that would occur when a user would reorder / move items between sections.
+
 # [16.0.0] - 2025-04-04
 
 ### Added
@@ -1141,7 +1200,14 @@ listActions.scrolling.scrollToSection(
 Earlier releases were ad-hoc and not tracked. To see all changes, please reference [closed PRs on Github](https://github.com/kyleve/Listable/pulls?q=is%3Apr+is%3Aclosed).
 
 
-[Main]: https://github.com/square/Listable/compare/16.0.0...main
+[Main]: https://github.com/square/Listable/compare/16.3.0...main
+[16.3.0]: https://github.com/square/Listable/compare/16.3.0...16.2.0
+[16.2.0]: https://github.com/square/Listable/compare/16.2.0...16.1.0
+[16.1.0]: https://github.com/square/Listable/compare/16.1.0...16.0.4
+[16.0.4]: https://github.com/square/Listable/compare/16.0.4...16.0.3
+[16.0.3]: https://github.com/square/Listable/compare/16.0.3...16.0.2
+[16.0.2]: https://github.com/square/Listable/compare/16.0.2...16.0.1
+[16.0.1]: https://github.com/square/Listable/compare/16.0.1...16.0.0
 [16.0.0]: https://github.com/square/Listable/compare/16.0.0...15.0.2
 [15.0.2]: https://github.com/square/Listable/compare/15.0.2...15.0.1
 [15.0.1]: https://github.com/square/Listable/compare/15.0.1...15.0.0