Skip to content

Commit 2134c91

Browse files
aaalanizaaalaniz
authored
Bump to 17.1.0 (#621)
### Added - Added item-aware content offset adjustment APIs, declarative auto-scroll support, and scroll-in-progress state for custom scrolling behaviors. ```swift list.autoScrollAction = .pin( .item(targetIdentifier), itemPosition: .verticalContentOffsetAdjustment { info in max(0.0, info.itemFrame.maxY - info.visibleContentFrame.maxY) }, scrollInterruptionPolicy: .deferDuringUserScrolling ) ``` Use `.skipDuringUserScrolling` instead when the auto-scroll should be dropped rather than retried after the user scroll ends. ### Checklist Please do the following before merging: - [x] Ensure any public-facing changes are reflected in the [changelog](https://github.com/square/Listable/blob/main/CHANGELOG.md). Include them in the `Main` section.
1 parent fe74f3f commit 2134c91

435 files changed

Lines changed: 11187 additions & 29 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,20 @@
44

55
### Added
66

7+
### Removed
8+
9+
### Changed
10+
11+
### Misc
12+
13+
### Internal
14+
15+
# Past Releases
16+
17+
# 17.1.0 - 2026-05-29
18+
19+
### Added
20+
721
- Added item-aware content offset adjustment APIs, declarative auto-scroll support, and scroll-in-progress state for custom scrolling behaviors.
822
```swift
923
list.autoScrollAction = .pin(
@@ -16,16 +30,6 @@
1630
```
1731
Use `.skipDuringUserScrolling` instead when the auto-scroll should be dropped rather than retried after the user scroll ends.
1832

19-
### Removed
20-
21-
### Changed
22-
23-
### Misc
24-
25-
### Internal
26-
27-
# Past Releases
28-
2933
# 17.0.1 - 2026-05-27
3034

3135
### Fixed

‎docs/BlueprintLists/docsets/BlueprintLists.tgz‎

-8 Bytes
Binary file not shown.

‎docs/Listable/Classes.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -139,6 +139,9 @@
139139
<li class="nav-group-task">
140140
<a class="nav-group-task-link" href="Enums/AutoScrollAction.html">AutoScrollAction</a>
141141
</li>
142+
<li class="nav-group-task">
143+
<a class="nav-group-task-link" href="Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
144+
</li>
142145
<li class="nav-group-task">
143146
<a class="nav-group-task-link" href="Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
144147
</li>
@@ -543,6 +546,12 @@
543546
<li class="nav-group-task">
544547
<a class="nav-group-task-link" href="Structs/ListEnvironment.html">ListEnvironment</a>
545548
</li>
549+
<li class="nav-group-task">
550+
<a class="nav-group-task-link" href="Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
551+
</li>
552+
<li class="nav-group-task">
553+
<a class="nav-group-task-link" href="Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
554+
</li>
546555
<li class="nav-group-task">
547556
<a class="nav-group-task-link" href="Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
548557
</li>
@@ -704,6 +713,9 @@
704713
<li class="nav-group-task">
705714
<a class="nav-group-task-link" href="Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
706715
</li>
716+
<li class="nav-group-task">
717+
<a class="nav-group-task-link" href="Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
718+
</li>
707719
</ul>
708720
</li>
709721
</ul>

‎docs/Listable/Classes/AnyIdentifier.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,9 @@
141141
<li class="nav-group-task">
142142
<a class="nav-group-task-link" href="../Enums/AutoScrollAction.html">AutoScrollAction</a>
143143
</li>
144+
<li class="nav-group-task">
145+
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
146+
</li>
144147
<li class="nav-group-task">
145148
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
146149
</li>
@@ -545,6 +548,12 @@
545548
<li class="nav-group-task">
546549
<a class="nav-group-task-link" href="../Structs/ListEnvironment.html">ListEnvironment</a>
547550
</li>
551+
<li class="nav-group-task">
552+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
553+
</li>
554+
<li class="nav-group-task">
555+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
556+
</li>
548557
<li class="nav-group-task">
549558
<a class="nav-group-task-link" href="../Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
550559
</li>
@@ -706,6 +715,9 @@
706715
<li class="nav-group-task">
707716
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
708717
</li>
718+
<li class="nav-group-task">
719+
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
720+
</li>
709721
</ul>
710722
</li>
711723
</ul>

‎docs/Listable/Classes/DefaultItemContentCoordinator.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,9 @@
141141
<li class="nav-group-task">
142142
<a class="nav-group-task-link" href="../Enums/AutoScrollAction.html">AutoScrollAction</a>
143143
</li>
144+
<li class="nav-group-task">
145+
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
146+
</li>
144147
<li class="nav-group-task">
145148
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
146149
</li>
@@ -545,6 +548,12 @@
545548
<li class="nav-group-task">
546549
<a class="nav-group-task-link" href="../Structs/ListEnvironment.html">ListEnvironment</a>
547550
</li>
551+
<li class="nav-group-task">
552+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
553+
</li>
554+
<li class="nav-group-task">
555+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
556+
</li>
548557
<li class="nav-group-task">
549558
<a class="nav-group-task-link" href="../Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
550559
</li>
@@ -706,6 +715,9 @@
706715
<li class="nav-group-task">
707716
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
708717
</li>
718+
<li class="nav-group-task">
719+
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
720+
</li>
709721
</ul>
710722
</li>
711723
</ul>

‎docs/Listable/Classes/DynamicSource.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,9 @@
141141
<li class="nav-group-task">
142142
<a class="nav-group-task-link" href="../Enums/AutoScrollAction.html">AutoScrollAction</a>
143143
</li>
144+
<li class="nav-group-task">
145+
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
146+
</li>
144147
<li class="nav-group-task">
145148
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
146149
</li>
@@ -545,6 +548,12 @@
545548
<li class="nav-group-task">
546549
<a class="nav-group-task-link" href="../Structs/ListEnvironment.html">ListEnvironment</a>
547550
</li>
551+
<li class="nav-group-task">
552+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
553+
</li>
554+
<li class="nav-group-task">
555+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
556+
</li>
548557
<li class="nav-group-task">
549558
<a class="nav-group-task-link" href="../Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
550559
</li>
@@ -706,6 +715,9 @@
706715
<li class="nav-group-task">
707716
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
708717
</li>
718+
<li class="nav-group-task">
719+
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
720+
</li>
709721
</ul>
710722
</li>
711723
</ul>

‎docs/Listable/Classes/Identifier.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,9 @@
141141
<li class="nav-group-task">
142142
<a class="nav-group-task-link" href="../Enums/AutoScrollAction.html">AutoScrollAction</a>
143143
</li>
144+
<li class="nav-group-task">
145+
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
146+
</li>
144147
<li class="nav-group-task">
145148
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
146149
</li>
@@ -545,6 +548,12 @@
545548
<li class="nav-group-task">
546549
<a class="nav-group-task-link" href="../Structs/ListEnvironment.html">ListEnvironment</a>
547550
</li>
551+
<li class="nav-group-task">
552+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
553+
</li>
554+
<li class="nav-group-task">
555+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
556+
</li>
548557
<li class="nav-group-task">
549558
<a class="nav-group-task-link" href="../Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
550559
</li>
@@ -706,6 +715,9 @@
706715
<li class="nav-group-task">
707716
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
708717
</li>
718+
<li class="nav-group-task">
719+
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
720+
</li>
709721
</ul>
710722
</li>
711723
</ul>

‎docs/Listable/Classes/ItemContentCoordinatorActions.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,9 @@
141141
<li class="nav-group-task">
142142
<a class="nav-group-task-link" href="../Enums/AutoScrollAction.html">AutoScrollAction</a>
143143
</li>
144+
<li class="nav-group-task">
145+
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
146+
</li>
144147
<li class="nav-group-task">
145148
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
146149
</li>
@@ -545,6 +548,12 @@
545548
<li class="nav-group-task">
546549
<a class="nav-group-task-link" href="../Structs/ListEnvironment.html">ListEnvironment</a>
547550
</li>
551+
<li class="nav-group-task">
552+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
553+
</li>
554+
<li class="nav-group-task">
555+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
556+
</li>
548557
<li class="nav-group-task">
549558
<a class="nav-group-task-link" href="../Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
550559
</li>
@@ -706,6 +715,9 @@
706715
<li class="nav-group-task">
707716
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
708717
</li>
718+
<li class="nav-group-task">
719+
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
720+
</li>
709721
</ul>
710722
</li>
711723
</ul>

‎docs/Listable/Classes/ItemContentCoordinatorInfo.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,9 @@
141141
<li class="nav-group-task">
142142
<a class="nav-group-task-link" href="../Enums/AutoScrollAction.html">AutoScrollAction</a>
143143
</li>
144+
<li class="nav-group-task">
145+
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
146+
</li>
144147
<li class="nav-group-task">
145148
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
146149
</li>
@@ -545,6 +548,12 @@
545548
<li class="nav-group-task">
546549
<a class="nav-group-task-link" href="../Structs/ListEnvironment.html">ListEnvironment</a>
547550
</li>
551+
<li class="nav-group-task">
552+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
553+
</li>
554+
<li class="nav-group-task">
555+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
556+
</li>
548557
<li class="nav-group-task">
549558
<a class="nav-group-task-link" href="../Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
550559
</li>
@@ -706,6 +715,9 @@
706715
<li class="nav-group-task">
707716
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
708717
</li>
718+
<li class="nav-group-task">
719+
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
720+
</li>
709721
</ul>
710722
</li>
711723
</ul>

‎docs/Listable/Classes/ItemPreviewView.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -141,6 +141,9 @@
141141
<li class="nav-group-task">
142142
<a class="nav-group-task-link" href="../Enums/AutoScrollAction.html">AutoScrollAction</a>
143143
</li>
144+
<li class="nav-group-task">
145+
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollInterruptionPolicy.html">– ScrollInterruptionPolicy</a>
146+
</li>
144147
<li class="nav-group-task">
145148
<a class="nav-group-task-link" href="../Enums/AutoScrollAction/ScrollDestination.html">– ScrollDestination</a>
146149
</li>
@@ -545,6 +548,12 @@
545548
<li class="nav-group-task">
546549
<a class="nav-group-task-link" href="../Structs/ListEnvironment.html">ListEnvironment</a>
547550
</li>
551+
<li class="nav-group-task">
552+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPosition.html">ListItemScrollPosition</a>
553+
</li>
554+
<li class="nav-group-task">
555+
<a class="nav-group-task-link" href="../Structs/ListItemScrollPositionInfo.html">ListItemScrollPositionInfo</a>
556+
</li>
548557
<li class="nav-group-task">
549558
<a class="nav-group-task-link" href="../Structs/ListLayoutAppearanceProperties.html">ListLayoutAppearanceProperties</a>
550559
</li>
@@ -706,6 +715,9 @@
706715
<li class="nav-group-task">
707716
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI13HeaderContenta">HeaderContent</a>
708717
</li>
718+
<li class="nav-group-task">
719+
<a class="nav-group-task-link" href="../Typealiases.html#/s:10ListableUI32ListItemScrollPositionAdjustmenta">ListItemScrollPositionAdjustment</a>
720+
</li>
709721
</ul>
710722
</li>
711723
</ul>

0 commit comments

Comments
 (0)