@jorgsowa/php-parser 3.2.5-1

package/src/ast/nowdoc.js

@@ -0,0 +1,26 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Literal = require("./literal");
+const KIND = "nowdoc";
+
+/**
+ * Defines a nowdoc string
+ * @constructor NowDoc
+ * @memberOf module:php-parser
+ * @extends {Literal}
+ * @property {string} label
+ * @property {string} raw
+ * @property {string} value
+ */
+module.exports = Literal.extends(
+  KIND,
+  function Nowdoc(value, raw, label, docs, location) {
+    Literal.apply(this, [KIND, value, raw, docs, location]);
+    this.label = label;
+  },
+);

package/src/ast/nullkeyword.js

@@ -0,0 +1,20 @@
+/**
+ * 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 = "nullkeyword";
+
+/**
+ * Represents the null keyword
+ * @constructor NullKeyword
+ * @memberOf module:php-parser
+ * @extends {Node}
+ */
+module.exports = Node.extends(KIND, function NullKeyword(raw, docs, location) {
+  Node.apply(this, [KIND, docs, location]);
+  this.raw = raw;
+});

package/src/ast/nullsafepropertylookup.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Lookup = require("./lookup");
+const KIND = "nullsafepropertylookup";
+
+/**
+ * Lookup to an object property
+ * @memberOf module:php-parser
+ * @constructor NullSafePropertyLookup
+ * @extends {Lookup}
+ */
+module.exports = Lookup.extends(
+  KIND,
+  function NullSafePropertyLookup(what, offset, docs, location) {
+    Lookup.apply(this, [KIND, what, offset, docs, location]);
+  },
+);

package/src/ast/number.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Literal = require("./literal");
+const KIND = "number";
+
+/**
+ * Defines a numeric value
+ * @constructor Number
+ * @memberOf module:php-parser
+ * @extends {Literal}
+ * @property {number} value
+ */
+module.exports = Literal.extends(
+  KIND,
+  function Number(value, raw, docs, location) {
+    Literal.apply(this, [KIND, value, raw, docs, location]);
+  },
+);

package/src/ast/offsetlookup.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Lookup = require("./lookup");
+const KIND = "offsetlookup";
+
+/**
+ * Lookup on an offset in an array
+ * @constructor OffsetLookup
+ * @memberOf module:php-parser
+ * @extends {Lookup}
+ */
+module.exports = Lookup.extends(
+  KIND,
+  function OffsetLookup(what, offset, docs, location) {
+    Lookup.apply(this, [KIND, what, offset, docs, location]);
+  },
+);

package/src/ast/operation.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Expr = require("./expression");
+const KIND = "operation";
+
+/**
+ * Defines binary operations
+ * @constructor Operation
+ * @memberOf module:php-parser
+ * @extends {Expression}
+ */
+module.exports = Expr.extends(KIND, function Operation(kind, docs, location) {
+  Expr.apply(this, [kind || KIND, docs, location]);
+});

package/src/ast/parameter.js

@@ -0,0 +1,61 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Declaration = require("./declaration");
+const KIND = "parameter";
+
+/**
+ * @memberOf module:php-parser
+ * @typedef {1} MODIFIER_PUBLIC
+ **/
+/**
+ * @memberOf module:php-parser
+ * @typedef {2} MODIFIER_PROTECTED
+ **/
+/**
+ * @memberOf module:php-parser
+ * @typedef {4} MODIFIER_PRIVATE
+ **/
+/**
+ * Defines a function parameter
+ * @constructor Parameter
+ * @memberOf module:php-parser
+ * @extends {Declaration}
+ * @property {Identifier|null} type
+ * @property {Node|null} value
+ * @property {boolean} byref
+ * @property {boolean} variadic
+ * @property {boolean} readonly
+ * @property {boolean} nullable
+ * @property {AttrGroup[]} attrGroups
+ * @property {MODIFIER_PUBLIC|MODIFIER_PROTECTED|MODIFIER_PRIVATE} flags
+ */
+module.exports = Declaration.extends(
+  KIND,
+  function Parameter(
+    name,
+    type,
+    value,
+    isRef,
+    isVariadic,
+    readonly,
+    nullable,
+    flags,
+    docs,
+    location,
+  ) {
+    Declaration.apply(this, [KIND, name, docs, location]);
+    this.value = value;
+    this.type = type;
+    this.byref = isRef;
+    this.variadic = isVariadic;
+    this.readonly = readonly;
+    this.nullable = nullable;
+    this.flags = flags || 0;
+    this.attrGroups = [];
+  },
+);

package/src/ast/parentreference.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 Reference = require("./reference");
+const KIND = "parentreference";
+
+/**
+ * Defines a class reference node
+ * @constructor ParentReference
+ * @memberOf module:php-parser
+ * @extends {Reference}
+ */
+const ParentReference = Reference.extends(
+  KIND,
+  function ParentReference(raw, docs, location) {
+    Reference.apply(this, [KIND, docs, location]);
+    this.raw = raw;
+  },
+);
+module.exports = ParentReference;

package/src/ast/position.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+/**
+ * Each Position object consists of a line number (1-indexed) and a column number (0-indexed):
+ * @constructor Position
+ * @memberOf module:php-parser
+ * @property {number} line
+ * @property {number} column
+ * @property {number} offset
+ */
+const Position = function (line, column, offset) {
+  this.line = line;
+  this.column = column;
+  this.offset = offset;
+};
+
+module.exports = Position;

package/src/ast/post.js

@@ -0,0 +1,26 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Operation = require("./operation");
+const KIND = "post";
+
+/**
+ * Defines a post operation `$i++` or `$i--`
+ * @constructor Post
+ * @memberOf module:php-parser
+ * @extends {Operation}
+ * @property {String} type
+ * @property {Variable} what
+ */
+module.exports = Operation.extends(
+  KIND,
+  function Post(type, what, docs, location) {
+    Operation.apply(this, [KIND, docs, location]);
+    this.type = type;
+    this.what = what;
+  },
+);

package/src/ast/pre.js

@@ -0,0 +1,26 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Operation = require("./operation");
+const KIND = "pre";
+
+/**
+ * Defines a pre operation `++$i` or `--$i`
+ * @constructor Pre
+ * @memberOf module:php-parser
+ * @extends {Operation}
+ * @property {String} type
+ * @property {Variable} what
+ */
+module.exports = Operation.extends(
+  KIND,
+  function Pre(type, what, docs, location) {
+    Operation.apply(this, [KIND, docs, location]);
+    this.type = type;
+    this.what = what;
+  },
+);

package/src/ast/print.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Expression = require("./expression");
+const KIND = "print";
+
+/**
+ * Outputs
+ * @constructor Print
+ * @memberOf module:php-parser
+ * @extends {Expression}
+ */
+module.exports = Expression.extends(
+  KIND,
+  function Print(expression, docs, location) {
+    Expression.apply(this, [KIND, docs, location]);
+    this.expression = expression;
+  },
+);

package/src/ast/program.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Block = require("./block");
+const KIND = "program";
+
+/**
+ * The main program node
+ * @constructor Program
+ * @memberOf module:php-parser
+ * @extends {Block}
+ * @property {Error[]} errors
+ * @property {Comment[]|null} comments
+ * @property {String[]|null} tokens
+ */
+module.exports = Block.extends(
+  KIND,
+  function Program(children, errors, comments, tokens, docs, location) {
+    Block.apply(this, [KIND, children, docs, location]);
+    this.errors = errors;
+    if (comments) {
+      this.comments = comments;
+    }
+    if (tokens) {
+      this.tokens = tokens;
+    }
+  },
+);

package/src/ast/property.js

@@ -0,0 +1,46 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Statement = require("./statement");
+const KIND = "property";
+
+/**
+ * Defines a class property
+ * @constructor Property
+ * @memberOf module:php-parser
+ * @extends {Statement}
+ * @property {string} name
+ * @property {Node|null} value
+ * @property {boolean} readonly
+ * @property {boolean} nullable
+ * @property {Identifier|Array<Identifier>|null} type
+ * @property {PropertyHook[]} hooks
+ * @property {AttrGroup[]} attrGroups
+ */
+module.exports = Statement.extends(
+  KIND,
+  function Property(
+    name,
+    value,
+    readonly,
+    nullable,
+    type,
+    hooks,
+    attrGroups,
+    docs,
+    location,
+  ) {
+    Statement.apply(this, [KIND, docs, location]);
+    this.name = name;
+    this.value = value;
+    this.readonly = readonly;
+    this.nullable = nullable;
+    this.type = type;
+    this.hooks = hooks;
+    this.attrGroups = attrGroups;
+  },
+);

package/src/ast/propertyhook.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright (C) 2024 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Node = require("./node");
+const KIND = "propertyhook";
+
+/**
+ * Defines a class property hook getter & setter
+ *
+ * @constructor PropertyHook
+ * @memberOf module:php-parser
+ * @extends {Node}
+ * @property {string} name
+ * @property {Boolean} isFinal
+ * @property {Boolean} byref
+ * @property {Parameter|null} parameter
+ * @property {Block|Statement} body
+ */
+module.exports = Node.extends(
+  KIND,
+  function PropertyHook(name, isFinal, byref, parameter, body, docs, location) {
+    Node.apply(this, [KIND, docs, location]);
+    this.name = name;
+    this.byref = byref;
+    this.parameter = parameter;
+    this.body = body;
+    this.isFinal = isFinal;
+  },
+);

package/src/ast/propertylookup.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Lookup = require("./lookup");
+const KIND = "propertylookup";
+
+/**
+ * Lookup to an object property
+ * @memberOf module:php-parser
+ * @constructor PropertyLookup
+ * @extends {Lookup}
+ */
+module.exports = Lookup.extends(
+  KIND,
+  function PropertyLookup(what, offset, docs, location) {
+    Lookup.apply(this, [KIND, what, offset, docs, location]);
+  },
+);

package/src/ast/propertystatement.js

@@ -0,0 +1,59 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Statement = require("./statement");
+const KIND = "propertystatement";
+
+const IS_UNDEFINED = "";
+const IS_PUBLIC = "public";
+const IS_PROTECTED = "protected";
+const IS_PRIVATE = "private";
+
+/**
+ * Declares a properties into the current scope
+ * @constructor PropertyStatement
+ * @memberOf module:php-parser
+ * @extends {Statement}
+ * @property {Property[]} properties
+ * @property {string|null} visibility
+ * @property {boolean} isStatic
+ */
+const PropertyStatement = Statement.extends(
+  KIND,
+  function PropertyStatement(kind, properties, flags, docs, location) {
+    Statement.apply(this, [KIND, docs, location]);
+    this.properties = properties;
+    this.parseFlags(flags);
+  },
+);
+
+/**
+ * Generic flags parser
+ * @function PropertyStatement#parseFlags
+ * @memberOf module:php-parser
+ * @param {Array<number|null>} flags
+ * @return {void}
+ */
+PropertyStatement.prototype.parseFlags = function (flags) {
+  if (flags[0] === -1) {
+    this.visibility = IS_UNDEFINED;
+  } else if (flags[0] === null) {
+    this.visibility = null;
+  } else if (flags[0] === 0) {
+    this.visibility = IS_PUBLIC;
+  } else if (flags[0] === 1) {
+    this.visibility = IS_PROTECTED;
+  } else if (flags[0] === 2) {
+    this.visibility = IS_PRIVATE;
+  }
+
+  this.isStatic = flags[1] === 1;
+  this.isAbstract = flags[2] === 1;
+  this.isFinal = flags[2] === 2;
+};
+
+module.exports = PropertyStatement;

package/src/ast/reference.js

@@ -0,0 +1,21 @@
+/**
+ * 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 = "reference";
+
+/**
+ * Defines a reference node
+ * @constructor Reference
+ * @memberOf module:php-parser
+ * @extends {Node}
+ */
+const Reference = Node.extends(KIND, function Reference(kind, docs, location) {
+  Node.apply(this, [kind || KIND, docs, location]);
+});
+
+module.exports = Reference;

package/src/ast/retif.js

@@ -0,0 +1,28 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Expression = require("./expression");
+const KIND = "retif";
+
+/**
+ * Defines a short if statement that returns a value
+ * @constructor RetIf
+ * @memberOf module:php-parser
+ * @extends {Expression}
+ * @property {Expression} test
+ * @property {Expression} trueExpr
+ * @property {Expression} falseExpr
+ */
+module.exports = Expression.extends(
+  KIND,
+  function RetIf(test, trueExpr, falseExpr, docs, location) {
+    Expression.apply(this, [KIND, docs, location]);
+    this.test = test;
+    this.trueExpr = trueExpr;
+    this.falseExpr = falseExpr;
+  },
+);

package/src/ast/return.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright (C) 2018 Glayzzle (BSD3 License)
+ * @authors https://github.com/glayzzle/php-parser/graphs/contributors
+ * @url http://glayzzle.com
+ */
+"use strict";
+
+const Statement = require("./statement");
+const KIND = "return";
+
+/**
+ * A continue statement
+ * @constructor Return
+ * @memberOf module:php-parser
+ * @extends {Statement}
+ * @property {Expression|null} expr
+ */
+module.exports = Statement.extends(KIND, function Return(expr, docs, location) {
+  Statement.apply(this, [KIND, docs, location]);
+  this.expr = expr;
+});

package/src/ast/selfreference.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 Reference = require("./reference");
+const KIND = "selfreference";
+
+/**
+ * Defines a class reference node
+ * @constructor SelfReference
+ * @memberOf module:php-parser
+ * @extends {Reference}
+ */
+const SelfReference = Reference.extends(
+  KIND,
+  function SelfReference(raw, docs, location) {
+    Reference.apply(this, [KIND, docs, location]);
+    this.raw = raw;
+  },
+);
+module.exports = SelfReference;

package/src/ast/silent.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 Expression = require("./expression");
+const KIND = "silent";
+
+/**
+ * Avoids to show/log warnings & notices from the inner expression
+ * @constructor Silent
+ * @memberOf module:php-parser
+ * @extends {Expression}
+ * @property {Expression} expr
+ */
+module.exports = Expression.extends(
+  KIND,
+  function Silent(expr, docs, location) {
+    Expression.apply(this, [KIND, docs, location]);
+    this.expr = expr;
+  },
+);

package/src/ast/statement.js

@@ -0,0 +1,19 @@
+/**
+ * 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 = "statement";
+
+/**
+ * Any statement.
+ * @constructor Statement
+ * @memberOf module:php-parser
+ * @extends {Node}
+ */
+module.exports = Node.extends(KIND, function Statement(kind, docs, location) {
+  Node.apply(this, [kind || KIND, docs, location]);
+});