Collection item scope provider (#2683)

Fixes #1059

Related #1052

## Checklist

- [x] I have added
[tests](https://www.cursorless.org/docs/contributing/test-case-recorder/)
- [/] I have updated the
[docs](https://github.com/cursorless-dev/cursorless/tree/main/docs) and
[cheatsheet](https://github.com/cursorless-dev/cursorless/tree/main/cursorless-talon/src/cheatsheet)
- [/] I have not broken the cheatsheet

---------

Co-authored-by: Phil Cohen <[email protected]>
Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com>

Author: 3 people

changelog/2025-01-addedCollectionItemScopeProvider.md

@@ -0,0 +1,6 @@
+---
+tags: [enhancement]
+pullRequest: 2683
+---
+
+At long last, collection items have been migrated to our next generation scope framework! This means, within a list of items, you can now use relative navigation (`previous item`), absolute navigation via ordinals (`fifth item`), multiple selection (`two items`, optionally preceded with `previous` or `next`), and lastly, requesting multiple items to be individually selected via `every` (`every two items`)!

data/fixtures/recorded/itemTextual/chuckItem4.yml

@@ -29,9 +29,7 @@ finalState:
   documentContents: |-
     {
         :foo "bar",
-        ;; hello
-    ,
     }
   selections:
-    - anchor: {line: 4, character: 1}
-      active: {line: 4, character: 1}
+    - anchor: {line: 2, character: 1}
+      active: {line: 2, character: 1}

data/fixtures/recorded/itemTextual/clearEveryItemToken.yml

@@ -27,11 +27,10 @@ finalState:
 
     {
         ,
-        ;; hello
         ,
     }
   selections:
     - anchor: {line: 2, character: 4}
       active: {line: 2, character: 4}
-    - anchor: {line: 4, character: 4}
-      active: {line: 4, character: 4}
+    - anchor: {line: 3, character: 4}
+      active: {line: 3, character: 4}

data/fixtures/recorded/itemTextual/clearItem10.yml

@@ -26,8 +26,11 @@ initialState:
 finalState:
   documentContents: |-
     {
-        
+        :bongo {
+            :foo "bar",
+            ,
+        }
     }
   selections:
-    - anchor: {line: 1, character: 4}
-      active: {line: 1, character: 4}
+    - anchor: {line: 3, character: 8}
+      active: {line: 3, character: 8}

data/fixtures/recorded/itemTextual/clearItem11.yml

@@ -21,7 +21,7 @@ initialState:
       start: {line: 0, character: 2}
       end: {line: 0, character: 5}
 finalState:
-  documentContents: "{ :baz \"whatever\"}"
+  documentContents: "{}"
   selections:
     - anchor: {line: 0, character: 1}
       active: {line: 0, character: 1}

data/fixtures/recorded/itemTextual/clearItem13.yml

@@ -23,7 +23,7 @@ initialState:
       end: {line: 0, character: 21}
 finalState:
   documentContents: |
-    let x = [None, ];
+    let x = [None, Some()];
   selections:
-    - anchor: {line: 0, character: 15}
-      active: {line: 0, character: 15}
+    - anchor: {line: 0, character: 20}
+      active: {line: 0, character: 20}