Add methods from List/Map to Listing/Mapping (#683)

* Add `values` to `Mapping`

* Add `entries` to `Mapping`

* Add `containsValue` to `Mapping`

* Add `every` to `Mapping`

* Add `any` to `Mapping`

* Add `toDynamic` to `Mapping`

* Add `lastIndex` to `Listing`

* Add `getOrNull` to `Listing`

* Add `first` to `Listing`

* Add `firstOrNull` to `Listing`

* Add `last` to `Listing`

* Add `lastOrNull` to `Listing`

* Add `single` to `Listing`

* Add `singleOrNull` to `Listing`

* Add `contains` to `Listing`

* Add `any` to `Listing`

* Add `every` to `Listing`

* Fixup `any` to `Listing`

* Revert "Add `toDynamic` to `Mapping`"

This reverts commit 5551974ecd8110aa2eb8f546e992c32d3181df9b.

* Revert "Add `values` to `Mapping`"

This reverts commit 6fc78796

* Revert "Add `entries` to `Mapping`"

This reverts commit a7e8dfc4

* Annotate new members with `Since` 0.27

* Fix documentation in `base.pkl`

* Add location information to empty/single checks in `Listing` operations

* Remove additional variable for laziness preservation

* Apply spotless

* Apply suggestions from code review

Co-authored-by: Daniel Chao <daniel.h.chao@gmail.com>

---------

Co-authored-by: Daniel Chao <daniel.h.chao@gmail.com>

pkl-core/src/test/files/LanguageSnippetTests/input/api/listing.pkl

@@ -23,6 +23,10 @@ local duplicate: Listing<Person> = (base) {
   new { name = "Elf Owl" }
 }
 
+local altered: Listing<Person> = (base) {
+  [0] { name = "Wood Pigeon" }
+}
+
 facts {
   ["isEmpty"] {
     empty.isEmpty
@@ -30,6 +34,14 @@ facts {
     !base.isEmpty
     !derived.isEmpty
   }
+  
+  ["lastIndex"] {
+    empty.lastIndex == -1
+    empty2.lastIndex == -1
+    base.lastIndex == 2
+    derived.lastIndex == 4
+    duplicate.lastIndex == 5
+  }
 
   ["isDistinct"] {
     empty.isDistinct
@@ -58,6 +70,72 @@ facts {
     !derived.isDistinctBy((it) -> it.getClass())
     !duplicate.isDistinctBy((it) -> it.getClass())
   }
+  
+  ["getOrNull"] {
+    empty.getOrNull(-1) == null
+    empty.getOrNull(0) == null
+    base.getOrNull(-1) == null
+    for (i, v in base) {
+      base.getOrNull(i) == v
+    }
+    base.getOrNull(base.length) == null
+  }
+  
+  ["first"] {
+    module.catch(() -> empty.first) == "Expected a non-empty Listing."
+    base.first == base[0]
+    derived.first == base[0]
+  }
+  
+  ["firstOrNull"] {
+    empty.firstOrNull == null
+    base.firstOrNull == base[0]
+    derived.firstOrNull == base[0]
+  }
+
+  ["last"] {
+    module.catch(() -> empty.last) == "Expected a non-empty Listing."
+    base.last == base[2]
+    derived.last == derived[4]
+  }
+
+  ["lastOrNull"] {
+    empty.lastOrNull == null
+    base.lastOrNull == base[2]
+    derived.lastOrNull == derived[4]
+  }
+
+  ["single"] {
+    module.catch(() -> empty.single) == "Expected a single-element Listing."
+    module.catch(() -> base.single) == "Expected a single-element Listing."
+    new Listing { 42 }.single == 42
+  }
+
+  ["singleOrNull"] {
+    empty.singleOrNull == null
+    base.singleOrNull == null
+    new Listing { 42 }.singleOrNull == 42
+  }
+
+  ["every"] {
+    !base.every((it) -> it.name.contains("rot"))
+    base.every((it) -> !it.name.isBlank)
+    !((base) { new { name = "EEEEE" } }).every((it) -> it.name.contains("rot"))
+  }
+  
+  ["any"] {
+    base.any((it) -> it.name.contains("rot"))
+    !base.any((it) -> it.name.contains("inch"))
+    ((base) { new { name = "EEEEE" } }).any((it) -> it.name.contains("rot"))
+  }
+
+  ["contains"] {
+    !empty.contains(0)
+    base.contains(base[1])
+    derived.contains(base[1])
+    derived.contains(derived[3])
+    !altered.contains(base[0])
+  }
 }
 
 examples {

pkl-core/src/test/files/LanguageSnippetTests/input/api/mapping.pkl

@@ -57,19 +57,26 @@ facts {
     !empty.containsKey("default")
     !empty2.containsKey("Pigeon")
   }
-  
+
+  ["containsValue()"] {
+    !empty.containsValue("Any value")
+    for (_, v in derived) {
+      derived.containsValue(v)
+    }
+  }
+
   ["length"] {
     empty.length == 0
     base.length == 2
     derived.length == 3
   }
-  
+
   ["keys (of type string)"] {
     empty.keys == Set()
     derived.keys == Set("Pigeon", "Parrot", "Barn Owl")
     base.keys == Set("Pigeon", "Parrot")
   }
-  
+
   ["keys (of type object)"] {
     local base2 = new Mapping {
       [empty] = "one"
@@ -82,6 +89,18 @@ facts {
     base2.keys == Set(empty, base)
     derived2.keys == Set(empty, base, derived)
   }
+
+  ["every()"] {
+    empty.every((_, _) -> throw("unreachable code"))
+    base.every((k, v) -> k == "Parrot" || v.age > 30)
+    !base.every((k, _) -> k == "Pigeon")
+  }
+
+  ["any()"] {
+    base.any((k, _) -> k.contains("rot"))
+    base.any((_, v) -> v.age > 40)
+    !base.any((k, _) -> k.contains("other"))
+  }
 }
 
 examples {

pkl-core/src/test/files/LanguageSnippetTests/output/api/listing.pcf

@@ -5,6 +5,13 @@ facts {
     true
     true
   }
+  ["lastIndex"] {
+    true
+    true
+    true
+    true
+    true
+  }
   ["isDistinct"] {
     true
     true
@@ -29,6 +36,62 @@ facts {
     true
     true
   }
+  ["getOrNull"] {
+    true
+    true
+    true
+    true
+    true
+    true
+    true
+  }
+  ["first"] {
+    true
+    true
+    true
+  }
+  ["firstOrNull"] {
+    true
+    true
+    true
+  }
+  ["last"] {
+    true
+    true
+    true
+  }
+  ["lastOrNull"] {
+    true
+    true
+    true
+  }
+  ["single"] {
+    true
+    true
+    true
+  }
+  ["singleOrNull"] {
+    true
+    true
+    true
+  }
+  ["every"] {
+    true
+    true
+    true
+  }
+  ["any"] {
+    true
+    true
+    true
+  }
+  ["contains"] {
+    true
+    true
+    true
+    true
+    true
+  }
 }
 examples {
   ["length"] {

pkl-core/src/test/files/LanguageSnippetTests/output/api/mapping.pcf

@@ -18,6 +18,12 @@ facts {
     true
     true
   }
+  ["containsValue()"] {
+    true
+    true
+    true
+    true
+  }
   ["length"] {
     true
     true
@@ -32,6 +38,16 @@ facts {
     true
     true
   }
+  ["every()"] {
+    true
+    true
+    true
+  }
+  ["any()"] {
+    true
+    true
+    true
+  }
 }
 examples {
   ["getOrNull()"] {