Add VariadicPlaceholder AST node.

Author: Maarten Staa

src/ast.js

@@ -580,6 +580,7 @@ AST.prototype.checkNodes = function () {
   require("./ast/useitem"),
   require("./ast/variable"),
   require("./ast/variadic"),
+  require("./ast/variadicplaceholder"),
   require("./ast/while"),
   require("./ast/yield"),
   require("./ast/yieldfrom"),

src/ast/variadicplaceholder.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Node = require("./node");
+const KIND = "variadicplaceholder";
+
+/**
+ * Defines a variadic placeholder (the ellipsis in PHP 8.1+'s first-class callable syntax)
+ * @constructor VariadicPlaceholder
+ * @memberOf module:php-parser
+ * @extends {Node}
+ * @see {Namespace}
+ * @see http://php.net/manual/en/language.namespaces.importing.php
+ */
+module.exports = Node.extends(
+  KIND,
+  function VariadicPlaceholder(docs, location) {
+    Node.apply(this, [KIND, docs, location]);
+  }
+);

src/parser/function.js

@@ -366,7 +366,7 @@ module.exports = {
     let result = [];
     this.expect("(") && this.next();
     if (this.token === this.tok.T_ELLIPSIS && this.peek() === ")") {
-      result.push(this.token);
+      result.push(this.node("variadicplaceholder")());
       this.next();
     } else if (this.token !== ")") {
       result = this.read_non_empty_argument_list();

test/snapshot/__snapshots__/function.test.js.snap

@@ -203,7 +203,9 @@ Program {
         "operator": "=",
         "right": Call {
           "arguments": Array [
-            229,
+            VariadicPlaceholder {
+              "kind": "variadicplaceholder",
+            },
           ],
           "kind": "call",
           "what": Name {
@@ -226,7 +228,9 @@ Program {
         "operator": "=",
         "right": Call {
           "arguments": Array [
-            229,
+            VariadicPlaceholder {
+              "kind": "variadicplaceholder",
+            },
           ],
           "kind": "call",
           "what": PropertyLookup {
@@ -256,7 +260,9 @@ Program {
         "operator": "=",
         "right": Call {
           "arguments": Array [
-            229,
+            VariadicPlaceholder {
+              "kind": "variadicplaceholder",
+            },
           ],
           "kind": "call",
           "what": StaticLookup {
@@ -286,7 +292,9 @@ Program {
         "operator": "=",
         "right": Call {
           "arguments": Array [
-            229,
+            VariadicPlaceholder {
+              "kind": "variadicplaceholder",
+            },
           ],
           "kind": "call",
           "what": StaticLookup {