@appthreat/atom 1.7.5 → 1.8.1

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation/Alias.php

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt\TraitUseAdaptation;
+
+use PhpParser\Node;
+
+class Alias extends Node\Stmt\TraitUseAdaptation {
+    /** @var null|int New modifier */
+    public ?int $newModifier;
+    /** @var null|Node\Identifier New name */
+    public ?Node\Identifier $newName;
+
+    /**
+     * Constructs a trait use precedence adaptation node.
+     *
+     * @param null|Node\Name $trait Trait name
+     * @param string|Node\Identifier $method Method name
+     * @param null|int $newModifier New modifier
+     * @param null|string|Node\Identifier $newName New name
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(?Node\Name $trait, $method, ?int $newModifier, $newName, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->trait = $trait;
+        $this->method = \is_string($method) ? new Node\Identifier($method) : $method;
+        $this->newModifier = $newModifier;
+        $this->newName = \is_string($newName) ? new Node\Identifier($newName) : $newName;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['trait', 'method', 'newModifier', 'newName'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_TraitUseAdaptation_Alias';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation/Precedence.php

@@ -0,0 +1,33 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt\TraitUseAdaptation;
+
+use PhpParser\Node;
+
+class Precedence extends Node\Stmt\TraitUseAdaptation {
+    /** @var Node\Name[] Overwritten traits */
+    public array $insteadof;
+
+    /**
+     * Constructs a trait use precedence adaptation node.
+     *
+     * @param Node\Name $trait Trait name
+     * @param string|Node\Identifier $method Method name
+     * @param Node\Name[] $insteadof Overwritten traits
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(Node\Name $trait, $method, array $insteadof, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->trait = $trait;
+        $this->method = \is_string($method) ? new Node\Identifier($method) : $method;
+        $this->insteadof = $insteadof;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['trait', 'method', 'insteadof'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_TraitUseAdaptation_Precedence';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/TraitUseAdaptation.php

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+abstract class TraitUseAdaptation extends Node\Stmt {
+    /** @var Node\Name|null Trait name */
+    public ?Node\Name $trait;
+    /** @var Node\Identifier Method name */
+    public Node\Identifier $method;
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/Trait_.php

@@ -0,0 +1,34 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class Trait_ extends ClassLike {
+    /**
+     * Constructs a trait node.
+     *
+     * @param string|Node\Identifier $name Name
+     * @param array{
+     *     stmts?: Node\Stmt[],
+     *     attrGroups?: Node\AttributeGroup[],
+     * } $subNodes Array of the following optional subnodes:
+     *             'stmts'      => array(): Statements
+     *             'attrGroups' => array(): PHP attribute groups
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct($name, array $subNodes = [], array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->name = \is_string($name) ? new Node\Identifier($name) : $name;
+        $this->stmts = $subNodes['stmts'] ?? [];
+        $this->attrGroups = $subNodes['attrGroups'] ?? [];
+    }
+
+    public function getSubNodeNames(): array {
+        return ['attrGroups', 'name', 'stmts'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Trait';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/TryCatch.php

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class TryCatch extends Node\Stmt {
+    /** @var Node\Stmt[] Statements */
+    public array $stmts;
+    /** @var Catch_[] Catches */
+    public array $catches;
+    /** @var null|Finally_ Optional finally node */
+    public ?Finally_ $finally;
+
+    /**
+     * Constructs a try catch node.
+     *
+     * @param Node\Stmt[] $stmts Statements
+     * @param Catch_[] $catches Catches
+     * @param null|Finally_ $finally Optional finally node
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $stmts, array $catches, ?Finally_ $finally = null, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->stmts = $stmts;
+        $this->catches = $catches;
+        $this->finally = $finally;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['stmts', 'catches', 'finally'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_TryCatch';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/Unset_.php

@@ -0,0 +1,29 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class Unset_ extends Node\Stmt {
+    /** @var Node\Expr[] Variables to unset */
+    public array $vars;
+
+    /**
+     * Constructs an unset node.
+     *
+     * @param Node\Expr[] $vars Variables to unset
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $vars, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->vars = $vars;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['vars'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Unset';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/UseUse.php

@@ -0,0 +1,3 @@
+<?php declare(strict_types=1);
+
+require __DIR__ . '/../UseItem.php';

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/Use_.php

@@ -0,0 +1,47 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node\Stmt;
+use PhpParser\Node\UseItem;
+
+class Use_ extends Stmt {
+    /**
+     * Unknown type. Both Stmt\Use_ / Stmt\GroupUse and Stmt\UseUse have a $type property, one of them will always be
+     * TYPE_UNKNOWN while the other has one of the three other possible types. For normal use statements the type on the
+     * Stmt\UseUse is unknown. It's only the other way around for mixed group use declarations.
+     */
+    public const TYPE_UNKNOWN = 0;
+    /** Class or namespace import */
+    public const TYPE_NORMAL = 1;
+    /** Function import */
+    public const TYPE_FUNCTION = 2;
+    /** Constant import */
+    public const TYPE_CONSTANT = 3;
+
+    /** @var self::TYPE_* Type of alias */
+    public int $type;
+    /** @var UseItem[] Aliases */
+    public array $uses;
+
+    /**
+     * Constructs an alias (use) list node.
+     *
+     * @param UseItem[] $uses Aliases
+     * @param Stmt\Use_::TYPE_* $type Type of alias
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $uses, int $type = self::TYPE_NORMAL, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->type = $type;
+        $this->uses = $uses;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['type', 'uses'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Use';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt/While_.php

@@ -0,0 +1,33 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class While_ extends Node\Stmt {
+    /** @var Node\Expr Condition */
+    public Node\Expr $cond;
+    /** @var Node\Stmt[] Statements */
+    public array $stmts;
+
+    /**
+     * Constructs a while node.
+     *
+     * @param Node\Expr $cond Condition
+     * @param Node\Stmt[] $stmts Statements
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(Node\Expr $cond, array $stmts = [], array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->cond = $cond;
+        $this->stmts = $stmts;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['cond', 'stmts'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_While';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/Stmt.php

@@ -0,0 +1,8 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+use PhpParser\NodeAbstract;
+
+abstract class Stmt extends NodeAbstract {
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/UnionType.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+class UnionType extends ComplexType {
+    /** @var (Identifier|Name|IntersectionType)[] Types */
+    public array $types;
+
+    /**
+     * Constructs a union type.
+     *
+     * @param (Identifier|Name|IntersectionType)[] $types Types
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $types, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->types = $types;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['types'];
+    }
+
+    public function getType(): string {
+        return 'UnionType';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/UseItem.php

@@ -0,0 +1,55 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+use PhpParser\Node;
+use PhpParser\NodeAbstract;
+use PhpParser\Node\Stmt\Use_;
+
+class UseItem extends NodeAbstract {
+    /**
+     * @var Use_::TYPE_* One of the Stmt\Use_::TYPE_* constants. Will only differ from TYPE_UNKNOWN for mixed group uses
+     */
+    public int $type;
+    /** @var Node\Name Namespace, class, function or constant to alias */
+    public Name $name;
+    /** @var Identifier|null Alias */
+    public ?Identifier $alias;
+
+    /**
+     * Constructs an alias (use) item node.
+     *
+     * @param Node\Name $name Namespace/Class to alias
+     * @param null|string|Identifier $alias Alias
+     * @param Use_::TYPE_* $type Type of the use element (for mixed group use only)
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(Node\Name $name, $alias = null, int $type = Use_::TYPE_UNKNOWN, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->type = $type;
+        $this->name = $name;
+        $this->alias = \is_string($alias) ? new Identifier($alias) : $alias;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['type', 'name', 'alias'];
+    }
+
+    /**
+     * Get alias. If not explicitly given this is the last component of the used name.
+     */
+    public function getAlias(): Identifier {
+        if (null !== $this->alias) {
+            return $this->alias;
+        }
+
+        return new Identifier($this->name->getLast());
+    }
+
+    public function getType(): string {
+        return 'UseItem';
+    }
+}
+
+// @deprecated compatibility alias
+class_alias(UseItem::class, Stmt\UseUse::class);

package/plugins/nikic/php-parser/lib/PhpParser/Node/VarLikeIdentifier.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+/**
+ * Represents a name that is written in source code with a leading dollar,
+ * but is not a proper variable. The leading dollar is not stored as part of the name.
+ *
+ * Examples: Names in property declarations are formatted as variables. Names in static property
+ * lookups are also formatted as variables.
+ */
+class VarLikeIdentifier extends Identifier {
+    public function getType(): string {
+        return 'VarLikeIdentifier';
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node/VariadicPlaceholder.php

@@ -0,0 +1,27 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+use PhpParser\NodeAbstract;
+
+/**
+ * Represents the "..." in "foo(...)" of the first-class callable syntax.
+ */
+class VariadicPlaceholder extends NodeAbstract {
+    /**
+     * Create a variadic argument placeholder (first-class callable syntax).
+     *
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $attributes = []) {
+        $this->attributes = $attributes;
+    }
+
+    public function getType(): string {
+        return 'VariadicPlaceholder';
+    }
+
+    public function getSubNodeNames(): array {
+        return [];
+    }
+}

package/plugins/nikic/php-parser/lib/PhpParser/Node.php

@@ -0,0 +1,146 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser;
+
+interface Node {
+    /**
+     * Gets the type of the node.
+     *
+     * @return string Type of the node
+     */
+    public function getType(): string;
+
+    /**
+     * Gets the names of the sub nodes.
+     *
+     * @return string[] Names of sub nodes
+     */
+    public function getSubNodeNames(): array;
+
+    /**
+     * Gets line the node started in (alias of getStartLine).
+     *
+     * @return int Start line (or -1 if not available)
+     *
+     * @deprecated Use getStartLine() instead
+     */
+    public function getLine(): int;
+
+    /**
+     * Gets line the node started in.
+     *
+     * Requires the 'startLine' attribute to be enabled in the lexer (enabled by default).
+     *
+     * @return int Start line (or -1 if not available)
+     */
+    public function getStartLine(): int;
+
+    /**
+     * Gets the line the node ended in.
+     *
+     * Requires the 'endLine' attribute to be enabled in the lexer (enabled by default).
+     *
+     * @return int End line (or -1 if not available)
+     */
+    public function getEndLine(): int;
+
+    /**
+     * Gets the token offset of the first token that is part of this node.
+     *
+     * The offset is an index into the array returned by Lexer::getTokens().
+     *
+     * Requires the 'startTokenPos' attribute to be enabled in the lexer (DISABLED by default).
+     *
+     * @return int Token start position (or -1 if not available)
+     */
+    public function getStartTokenPos(): int;
+
+    /**
+     * Gets the token offset of the last token that is part of this node.
+     *
+     * The offset is an index into the array returned by Lexer::getTokens().
+     *
+     * Requires the 'endTokenPos' attribute to be enabled in the lexer (DISABLED by default).
+     *
+     * @return int Token end position (or -1 if not available)
+     */
+    public function getEndTokenPos(): int;
+
+    /**
+     * Gets the file offset of the first character that is part of this node.
+     *
+     * Requires the 'startFilePos' attribute to be enabled in the lexer (DISABLED by default).
+     *
+     * @return int File start position (or -1 if not available)
+     */
+    public function getStartFilePos(): int;
+
+    /**
+     * Gets the file offset of the last character that is part of this node.
+     *
+     * Requires the 'endFilePos' attribute to be enabled in the lexer (DISABLED by default).
+     *
+     * @return int File end position (or -1 if not available)
+     */
+    public function getEndFilePos(): int;
+
+    /**
+     * Gets all comments directly preceding this node.
+     *
+     * The comments are also available through the "comments" attribute.
+     *
+     * @return Comment[]
+     */
+    public function getComments(): array;
+
+    /**
+     * Gets the doc comment of the node.
+     *
+     * @return null|Comment\Doc Doc comment object or null
+     */
+    public function getDocComment(): ?Comment\Doc;
+
+    /**
+     * Sets the doc comment of the node.
+     *
+     * This will either replace an existing doc comment or add it to the comments array.
+     *
+     * @param Comment\Doc $docComment Doc comment to set
+     */
+    public function setDocComment(Comment\Doc $docComment): void;
+
+    /**
+     * Sets an attribute on a node.
+     *
+     * @param mixed $value
+     */
+    public function setAttribute(string $key, $value): void;
+
+    /**
+     * Returns whether an attribute exists.
+     */
+    public function hasAttribute(string $key): bool;
+
+    /**
+     * Returns the value of an attribute.
+     *
+     * @param mixed $default
+     *
+     * @return mixed
+     */
+    public function getAttribute(string $key, $default = null);
+
+    /**
+     * Returns all the attributes of this node.
+     *
+     * @return array<string, mixed>
+     */
+    public function getAttributes(): array;
+
+    /**
+     * Replaces all the attributes of this node.
+     *
+     * @param array<string, mixed> $attributes
+     */
+    public function setAttributes(array $attributes): void;
+}