@appthreat/atom 1.7.5 → 1.8.1

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

@@ -0,0 +1,154 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Modifiers;
+use PhpParser\Node;
+use PhpParser\Node\FunctionLike;
+
+class ClassMethod extends Node\Stmt implements FunctionLike {
+    /** @var int Flags */
+    public int $flags;
+    /** @var bool Whether to return by reference */
+    public bool $byRef;
+    /** @var Node\Identifier Name */
+    public Node\Identifier $name;
+    /** @var Node\Param[] Parameters */
+    public array $params;
+    /** @var null|Node\Identifier|Node\Name|Node\ComplexType Return type */
+    public ?Node $returnType;
+    /** @var Node\Stmt[]|null Statements */
+    public ?array $stmts;
+    /** @var Node\AttributeGroup[] PHP attribute groups */
+    public array $attrGroups;
+
+    /** @var array<string, bool> */
+    private static array $magicNames = [
+        '__construct'   => true,
+        '__destruct'    => true,
+        '__call'        => true,
+        '__callstatic'  => true,
+        '__get'         => true,
+        '__set'         => true,
+        '__isset'       => true,
+        '__unset'       => true,
+        '__sleep'       => true,
+        '__wakeup'      => true,
+        '__tostring'    => true,
+        '__set_state'   => true,
+        '__clone'       => true,
+        '__invoke'      => true,
+        '__debuginfo'   => true,
+        '__serialize'   => true,
+        '__unserialize' => true,
+    ];
+
+    /**
+     * Constructs a class method node.
+     *
+     * @param string|Node\Identifier $name Name
+     * @param array{
+     *     flags?: int,
+     *     byRef?: bool,
+     *     params?: Node\Param[],
+     *     returnType?: null|Node\Identifier|Node\Name|Node\ComplexType,
+     *     stmts?: Node\Stmt[]|null,
+     *     attrGroups?: Node\AttributeGroup[],
+     * } $subNodes Array of the following optional subnodes:
+     *             'flags       => 0              : Flags
+     *             'byRef'      => false          : Whether to return by reference
+     *             'params'     => array()        : Parameters
+     *             'returnType' => null           : Return type
+     *             '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->flags = $subNodes['flags'] ?? $subNodes['type'] ?? 0;
+        $this->byRef = $subNodes['byRef'] ?? false;
+        $this->name = \is_string($name) ? new Node\Identifier($name) : $name;
+        $this->params = $subNodes['params'] ?? [];
+        $this->returnType = $subNodes['returnType'] ?? null;
+        $this->stmts = array_key_exists('stmts', $subNodes) ? $subNodes['stmts'] : [];
+        $this->attrGroups = $subNodes['attrGroups'] ?? [];
+    }
+
+    public function getSubNodeNames(): array {
+        return ['attrGroups', 'flags', 'byRef', 'name', 'params', 'returnType', 'stmts'];
+    }
+
+    public function returnsByRef(): bool {
+        return $this->byRef;
+    }
+
+    public function getParams(): array {
+        return $this->params;
+    }
+
+    public function getReturnType() {
+        return $this->returnType;
+    }
+
+    public function getStmts(): ?array {
+        return $this->stmts;
+    }
+
+    public function getAttrGroups(): array {
+        return $this->attrGroups;
+    }
+
+    /**
+     * Whether the method is explicitly or implicitly public.
+     */
+    public function isPublic(): bool {
+        return ($this->flags & Modifiers::PUBLIC) !== 0
+            || ($this->flags & Modifiers::VISIBILITY_MASK) === 0;
+    }
+
+    /**
+     * Whether the method is protected.
+     */
+    public function isProtected(): bool {
+        return (bool) ($this->flags & Modifiers::PROTECTED);
+    }
+
+    /**
+     * Whether the method is private.
+     */
+    public function isPrivate(): bool {
+        return (bool) ($this->flags & Modifiers::PRIVATE);
+    }
+
+    /**
+     * Whether the method is abstract.
+     */
+    public function isAbstract(): bool {
+        return (bool) ($this->flags & Modifiers::ABSTRACT);
+    }
+
+    /**
+     * Whether the method is final.
+     */
+    public function isFinal(): bool {
+        return (bool) ($this->flags & Modifiers::FINAL);
+    }
+
+    /**
+     * Whether the method is static.
+     */
+    public function isStatic(): bool {
+        return (bool) ($this->flags & Modifiers::STATIC);
+    }
+
+    /**
+     * Whether the method is magic.
+     */
+    public function isMagic(): bool {
+        return isset(self::$magicNames[$this->name->toLowerString()]);
+    }
+
+    public function getType(): string {
+        return 'Stmt_ClassMethod';
+    }
+}

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

@@ -0,0 +1,94 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Modifiers;
+use PhpParser\Node;
+
+class Class_ extends ClassLike {
+    /** @deprecated Use Modifiers::PUBLIC instead */
+    public const MODIFIER_PUBLIC    =  1;
+    /** @deprecated Use Modifiers::PROTECTED instead */
+    public const MODIFIER_PROTECTED =  2;
+    /** @deprecated Use Modifiers::PRIVATE instead */
+    public const MODIFIER_PRIVATE   =  4;
+    /** @deprecated Use Modifiers::STATIC instead */
+    public const MODIFIER_STATIC    =  8;
+    /** @deprecated Use Modifiers::ABSTRACT instead */
+    public const MODIFIER_ABSTRACT  = 16;
+    /** @deprecated Use Modifiers::FINAL instead */
+    public const MODIFIER_FINAL     = 32;
+    /** @deprecated Use Modifiers::READONLY instead */
+    public const MODIFIER_READONLY  = 64;
+
+    /** @deprecated Use Modifiers::VISIBILITY_MASK instead */
+    public const VISIBILITY_MODIFIER_MASK = 7; // 1 | 2 | 4
+
+    /** @var int Modifiers */
+    public int $flags;
+    /** @var null|Node\Name Name of extended class */
+    public ?Node\Name $extends;
+    /** @var Node\Name[] Names of implemented interfaces */
+    public array $implements;
+
+    /**
+     * Constructs a class node.
+     *
+     * @param string|Node\Identifier|null $name Name
+     * @param array{
+     *     flags?: int,
+     *     extends?: Node\Name|null,
+     *     implements?: Node\Name[],
+     *     stmts?: Node\Stmt[],
+     *     attrGroups?: Node\AttributeGroup[],
+     * } $subNodes Array of the following optional subnodes:
+     *             'flags'       => 0      : Flags
+     *             'extends'     => null   : Name of extended class
+     *             'implements'  => array(): Names of implemented interfaces
+     *             '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->flags = $subNodes['flags'] ?? $subNodes['type'] ?? 0;
+        $this->name = \is_string($name) ? new Node\Identifier($name) : $name;
+        $this->extends = $subNodes['extends'] ?? null;
+        $this->implements = $subNodes['implements'] ?? [];
+        $this->stmts = $subNodes['stmts'] ?? [];
+        $this->attrGroups = $subNodes['attrGroups'] ?? [];
+    }
+
+    public function getSubNodeNames(): array {
+        return ['attrGroups', 'flags', 'name', 'extends', 'implements', 'stmts'];
+    }
+
+    /**
+     * Whether the class is explicitly abstract.
+     */
+    public function isAbstract(): bool {
+        return (bool) ($this->flags & Modifiers::ABSTRACT);
+    }
+
+    /**
+     * Whether the class is final.
+     */
+    public function isFinal(): bool {
+        return (bool) ($this->flags & Modifiers::FINAL);
+    }
+
+    public function isReadonly(): bool {
+        return (bool) ($this->flags & Modifiers::READONLY);
+    }
+
+    /**
+     * Whether the class is anonymous.
+     */
+    public function isAnonymous(): bool {
+        return null === $this->name;
+    }
+
+    public function getType(): string {
+        return 'Stmt_Class';
+    }
+}

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

@@ -0,0 +1,29 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class Const_ extends Node\Stmt {
+    /** @var Node\Const_[] Constant declarations */
+    public array $consts;
+
+    /**
+     * Constructs a const list node.
+     *
+     * @param Node\Const_[] $consts Constant declarations
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $consts, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->consts = $consts;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['consts'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Const';
+    }
+}

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

@@ -0,0 +1,29 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class Continue_ extends Node\Stmt {
+    /** @var null|Node\Expr Number of loops to continue */
+    public ?Node\Expr $num;
+
+    /**
+     * Constructs a continue node.
+     *
+     * @param null|Node\Expr $num Number of loops to continue
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(?Node\Expr $num = null, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->num = $num;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['num'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Continue';
+    }
+}

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

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

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

@@ -0,0 +1,34 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+use PhpParser\Node\DeclareItem;
+
+class Declare_ extends Node\Stmt {
+    /** @var DeclareItem[] List of declares */
+    public array $declares;
+    /** @var Node\Stmt[]|null Statements */
+    public ?array $stmts;
+
+    /**
+     * Constructs a declare node.
+     *
+     * @param DeclareItem[] $declares List of declares
+     * @param Node\Stmt[]|null $stmts Statements
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $declares, ?array $stmts = null, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->declares = $declares;
+        $this->stmts = $stmts;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['declares', 'stmts'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Declare';
+    }
+}

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

@@ -0,0 +1,33 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class Do_ extends Node\Stmt {
+    /** @var Node\Stmt[] Statements */
+    public array $stmts;
+    /** @var Node\Expr Condition */
+    public Node\Expr $cond;
+
+    /**
+     * Constructs a do 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 ['stmts', 'cond'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Do';
+    }
+}

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

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

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

@@ -0,0 +1,33 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class ElseIf_ extends Node\Stmt {
+    /** @var Node\Expr Condition */
+    public Node\Expr $cond;
+    /** @var Node\Stmt[] Statements */
+    public array $stmts;
+
+    /**
+     * Constructs an elseif 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_ElseIf';
+    }
+}

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

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

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

@@ -0,0 +1,36 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+use PhpParser\Node\AttributeGroup;
+
+class EnumCase extends Node\Stmt {
+    /** @var Node\Identifier Enum case name */
+    public Node\Identifier $name;
+    /** @var Node\Expr|null Enum case expression */
+    public ?Node\Expr $expr;
+    /** @var Node\AttributeGroup[] PHP attribute groups */
+    public array $attrGroups;
+
+    /**
+     * @param string|Node\Identifier $name Enum case name
+     * @param Node\Expr|null $expr Enum case expression
+     * @param list<AttributeGroup> $attrGroups PHP attribute groups
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct($name, ?Node\Expr $expr = null, array $attrGroups = [], array $attributes = []) {
+        parent::__construct($attributes);
+        $this->name = \is_string($name) ? new Node\Identifier($name) : $name;
+        $this->expr = $expr;
+        $this->attrGroups = $attrGroups;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['attrGroups', 'name', 'expr'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_EnumCase';
+    }
+}

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

@@ -0,0 +1,44 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class Enum_ extends ClassLike {
+    /** @var null|Node\Identifier Scalar Type */
+    public ?Node $scalarType;
+    /** @var Node\Name[] Names of implemented interfaces */
+    public array $implements;
+
+    /**
+     * @param string|Node\Identifier|null $name Name
+     * @param array{
+     *     scalarType?: Node\Identifier|null,
+     *     implements?: Node\Name[],
+     *     stmts?: Node\Stmt[],
+     *     attrGroups?: Node\AttributeGroup[],
+     * } $subNodes Array of the following optional subnodes:
+     *             'scalarType'  => null    : Scalar type
+     *             'implements'  => array() : Names of implemented interfaces
+     *             'stmts'       => array() : Statements
+     *             'attrGroups'  => array() : PHP attribute groups
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct($name, array $subNodes = [], array $attributes = []) {
+        $this->name = \is_string($name) ? new Node\Identifier($name) : $name;
+        $this->scalarType = $subNodes['scalarType'] ?? null;
+        $this->implements = $subNodes['implements'] ?? [];
+        $this->stmts = $subNodes['stmts'] ?? [];
+        $this->attrGroups = $subNodes['attrGroups'] ?? [];
+
+        parent::__construct($attributes);
+    }
+
+    public function getSubNodeNames(): array {
+        return ['attrGroups', 'name', 'scalarType', 'implements', 'stmts'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Enum';
+    }
+}

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

@@ -0,0 +1,32 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+/**
+ * Represents statements of type "expr;"
+ */
+class Expression extends Node\Stmt {
+    /** @var Node\Expr Expression */
+    public Node\Expr $expr;
+
+    /**
+     * Constructs an expression statement.
+     *
+     * @param Node\Expr $expr Expression
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(Node\Expr $expr, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->expr = $expr;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['expr'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_Expression';
+    }
+}

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

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

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

@@ -0,0 +1,47 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Stmt;
+
+use PhpParser\Node;
+
+class For_ extends Node\Stmt {
+    /** @var Node\Expr[] Init expressions */
+    public array $init;
+    /** @var Node\Expr[] Loop conditions */
+    public array $cond;
+    /** @var Node\Expr[] Loop expressions */
+    public array $loop;
+    /** @var Node\Stmt[] Statements */
+    public array $stmts;
+
+    /**
+     * Constructs a for loop node.
+     *
+     * @param array{
+     *     init?: Node\Expr[],
+     *     cond?: Node\Expr[],
+     *     loop?: Node\Expr[],
+     *     stmts?: Node\Stmt[],
+     * } $subNodes Array of the following optional subnodes:
+     *             'init'  => array(): Init expressions
+     *             'cond'  => array(): Loop conditions
+     *             'loop'  => array(): Loop expressions
+     *             'stmts' => array(): Statements
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $subNodes = [], array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->init = $subNodes['init'] ?? [];
+        $this->cond = $subNodes['cond'] ?? [];
+        $this->loop = $subNodes['loop'] ?? [];
+        $this->stmts = $subNodes['stmts'] ?? [];
+    }
+
+    public function getSubNodeNames(): array {
+        return ['init', 'cond', 'loop', 'stmts'];
+    }
+
+    public function getType(): string {
+        return 'Stmt_For';
+    }
+}