Deprecate Schema::entries in favor to Schema::references (#1137)

* Deprecate Schema::entries in favor to Schema::references

* Added References::names() helper method

src/core/etl/src/Flow/ETL/Row/References.php

@@ -92,6 +92,20 @@ public function has(string|Reference $reference) : bool
         return false;
     }
 
+    /**
+     * @return array<string>
+     */
+    public function names() : array
+    {
+        $names = [];
+
+        foreach ($this->refs as $ref) {
+            $names[] = $ref->name();
+        }
+
+        return $names;
+    }
+
     /**
      * @param string $offset
      *

src/core/etl/src/Flow/ETL/Row/Schema.php

@@ -55,17 +55,13 @@ public function definitions() : array
     }
 
     /**
+     * @deprecated use references() : References instead
+     *
      * @return array<Reference>
      */
     public function entries() : array
     {
-        $refs = [];
-
-        foreach ($this->definitions as $definition) {
-            $refs[] = $definition->entry();
-        }
-
-        return $refs;
+        return $this->references()->all();
     }
 
     public function findDefinition(string|Reference $ref) : ?Definition
@@ -211,6 +207,17 @@ public function nullable() : self
         return $this->makeNullable();
     }
 
+    public function references() : References
+    {
+        $refs = [];
+
+        foreach ($this->definitions as $definition) {
+            $refs[] = $definition->entry();
+        }
+
+        return References::init(...$refs);
+    }
+
     public function remove(string|Reference ...$entries) : self
     {
         $refs = References::init(...$entries);

src/core/etl/src/Flow/ETL/Row/Schema/SelectiveValidator.php

@@ -15,7 +15,7 @@ final class SelectiveValidator implements SchemaValidator
 {
     public function isValid(Rows $rows, Schema $schema) : bool
     {
-        foreach ($schema->entries() as $ref) {
+        foreach ($schema->references() as $ref) {
             $definition = $schema->getDefinition($ref);
 
             foreach ($rows as $row) {

src/core/etl/tests/Flow/ETL/Tests/Unit/Row/ReferencesTest.php

@@ -20,6 +20,16 @@ public function test_lazy_without() : void
         );
     }
 
+    public function test_references_names() : void
+    {
+        $refs = refs('id', 'name');
+
+        self::assertEquals(
+            ['id', 'name'],
+            $refs->names()
+        );
+    }
+
     public function test_that_reference_with_alias_exists() : void
     {
         $refs = new References(ref('id')->as('test'), ref('name'));