feat(type): add support for $page->references() api

* Trim whitespace

* Add $page->references() to PageType

Author: dsdsdsdsdsds

ProcessGraphQLConfig.php

@@ -45,6 +45,7 @@ public function getDefaults()
         'name',
         'httpUrl',
         'template',
+        'references',
         ],
 
       /**
@@ -113,12 +114,12 @@ public function generatePages()
       $this->files->copy($from, $to);
       $this->message(sprintf($this->_('Created template files: %s'), 'graphql.php & graphiql.php'));
     } catch(\Exception $e) {
-      $this->error($e->getMessage()); 
+      $this->error($e->getMessage());
     }
-    
+
     foreach($pageNames as $name => $title) {
 
-      // create the templates  
+      // create the templates
       try {
         $template = $this->wire(new Template());
         $template->name = $name;
@@ -131,10 +132,10 @@ public function generatePages()
         $template->noAppendTemplateFile = true;
         $template->noPrependTemplateFile = true;
         $template->save();
-        $this->message(sprintf($this->_('Added template and fieldgroup: %s'), $name)); 
+        $this->message(sprintf($this->_('Added template and fieldgroup: %s'), $name));
       } catch(\Exception $e) {
-        $this->error($e->getMessage()); 
-        continue; 
+        $this->error($e->getMessage());
+        continue;
       }
 
       // create the pages
@@ -145,10 +146,10 @@ public function generatePages()
         $p->parent = $this->pages->get(1); // root page
         $p->title = $title;
         $p->save();
-        $this->message(sprintf($this->_('Created page: %s'), $name)); 
+        $this->message(sprintf($this->_('Created page: %s'), $name));
       } catch(\Exception $e) {
-        $this->error($e->getMessage()); 
-        continue; 
+        $this->error($e->getMessage());
+        continue;
       }
     }
   }

src/Type/PageType.php

@@ -52,15 +52,15 @@ public static function getBuiltInFields()
       self::resolvePagefieldWithSelector([
         'name' => 'child',
         'type' => $type,
-        'description' => "The first child of this page. If the `s`(selector) argument is provided then the 
+        'description' => "The first child of this page. If the `s`(selector) argument is provided then the
                           first matching child (subpage) that matches the given selector. Returns a Page or null.",
       ]),
 
       self::resolvePagefieldWithSelector([
         'name' => 'children',
         'type' => PageArrayType::type(),
-        'description' => "The number of children (subpages) this page has, optionally limiting to visible 
-                          pages. When argument `visible` true, number includes only visible children 
+        'description' => "The number of children (subpages) this page has, optionally limiting to visible
+                          pages. When argument `visible` true, number includes only visible children
                           (excludes unpublished, hidden, no-access, etc.)",
       ]),
 
@@ -109,8 +109,8 @@ public static function getBuiltInFields()
       [
         'name' => 'numChildren',
         'type' => Type::nonNull(Type::int()),
-        'description' => "The number of children (subpages) this page has, optionally limiting to 
-                          visible pages. When argument `visible` true, number includes only visible 
+        'description' => "The number of children (subpages) this page has, optionally limiting to
+                          visible pages. When argument `visible` true, number includes only visible
                           children (excludes unpublished, hidden, no-access, etc.)",
         'args' => [
           'visible' => [
@@ -153,6 +153,12 @@ public static function getBuiltInFields()
         'description' => "The page's URL path from the homepage (i.e. /about/staff/ryan/)",
       ],
 
+      self::resolveReferencesWithSelector([
+        'name' => 'references',
+        'type' => Type::nonNull(PageArrayType::type()),
+        'description' => "Return this page's parent pages as PageArray. Optionally filtered by a selector and a field name.",
+      ]),
+
       [
         'name' => 'template',
         'type' => Type::nonNull(Type::string()),
@@ -273,6 +279,35 @@ public static function resolvePagefieldWithSelector(array $options)
     ]);
   }
 
+  public static function resolveReferencesWithSelector(array $options)
+  {
+    return array_merge($options, [
+      'args' => [
+        's' => [
+          'type' => SelectorType::type(),
+          'description' => "ProcessWire selector."
+        ],
+        'f' => [
+          'type' => Type::string(), // TODO: could also be of type Field or bool
+          'description' => "ProcessWire field name."
+        ]
+      ],
+      'resolve' => function (Page $page, array $args) use ($options) {
+        $name = $options['name'];
+        $selector = "";
+        if (isset($args['s'])) {
+          $selector = SelectorType::parseValue($args['s']);
+        } else {
+          $selector = SelectorType::parseValue("");
+        }
+        $field = isset($args['f']) ? $args['f'] : "";
+        $result = $page->$name($selector, $field);
+        if ($result instanceof NullPage) return null;
+        return $result;
+      }
+    ]);
+  }
+
   public static function getEmptyUser()
   {
     if (self::$emptyUser instanceof WireData) {
@@ -321,7 +356,7 @@ public static function resolveWithDateFormatter(array $options)
       ],
       'resolve' => function (Page $page, array $args) use ($options) {
         $name = $options['name'];
-    
+
         if (isset($args['format'])) {
           $format = $args['format'];
           $rawValue = $page->$name;
@@ -331,7 +366,7 @@ public static function resolveWithDateFormatter(array $options)
             return "";
           }
         }
-        
+
         return $page->$name;
       }
     ]);