@appthreat/atom 1.7.5 → 1.8.1

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

@@ -0,0 +1,49 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Name;
+
+class Relative extends \PhpParser\Node\Name {
+    /**
+     * Checks whether the name is unqualified. (E.g. Name)
+     *
+     * @return bool Whether the name is unqualified
+     */
+    public function isUnqualified(): bool {
+        return false;
+    }
+
+    /**
+     * Checks whether the name is qualified. (E.g. Name\Name)
+     *
+     * @return bool Whether the name is qualified
+     */
+    public function isQualified(): bool {
+        return false;
+    }
+
+    /**
+     * Checks whether the name is fully qualified. (E.g. \Name)
+     *
+     * @return bool Whether the name is fully qualified
+     */
+    public function isFullyQualified(): bool {
+        return false;
+    }
+
+    /**
+     * Checks whether the name is explicitly relative to the current namespace. (E.g. namespace\Name)
+     *
+     * @return bool Whether the name is relative
+     */
+    public function isRelative(): bool {
+        return true;
+    }
+
+    public function toCodeString(): string {
+        return 'namespace\\' . $this->toString();
+    }
+
+    public function getType(): string {
+        return 'Name_Relative';
+    }
+}

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

@@ -0,0 +1,269 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+use PhpParser\NodeAbstract;
+
+class Name extends NodeAbstract {
+    /** @var string Name as string */
+    public string $name;
+
+    /** @var array<string, bool> */
+    private static array $specialClassNames = [
+        'self'   => true,
+        'parent' => true,
+        'static' => true,
+    ];
+
+    /**
+     * Constructs a name node.
+     *
+     * @param string|string[]|self $name Name as string, part array or Name instance (copy ctor)
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    final public function __construct($name, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->name = self::prepareName($name);
+    }
+
+    public function getSubNodeNames(): array {
+        return ['name'];
+    }
+
+    /**
+     * Get parts of name (split by the namespace separator).
+     *
+     * @return string[] Parts of name
+     */
+    public function getParts(): array {
+        return \explode('\\', $this->name);
+    }
+
+    /**
+     * Gets the first part of the name, i.e. everything before the first namespace separator.
+     *
+     * @return string First part of the name
+     */
+    public function getFirst(): string {
+        if (false !== $pos = \strpos($this->name, '\\')) {
+            return \substr($this->name, 0, $pos);
+        }
+        return $this->name;
+    }
+
+    /**
+     * Gets the last part of the name, i.e. everything after the last namespace separator.
+     *
+     * @return string Last part of the name
+     */
+    public function getLast(): string {
+        if (false !== $pos = \strrpos($this->name, '\\')) {
+            return \substr($this->name, $pos + 1);
+        }
+        return $this->name;
+    }
+
+    /**
+     * Checks whether the name is unqualified. (E.g. Name)
+     *
+     * @return bool Whether the name is unqualified
+     */
+    public function isUnqualified(): bool {
+        return false === \strpos($this->name, '\\');
+    }
+
+    /**
+     * Checks whether the name is qualified. (E.g. Name\Name)
+     *
+     * @return bool Whether the name is qualified
+     */
+    public function isQualified(): bool {
+        return false !== \strpos($this->name, '\\');
+    }
+
+    /**
+     * Checks whether the name is fully qualified. (E.g. \Name)
+     *
+     * @return bool Whether the name is fully qualified
+     */
+    public function isFullyQualified(): bool {
+        return false;
+    }
+
+    /**
+     * Checks whether the name is explicitly relative to the current namespace. (E.g. namespace\Name)
+     *
+     * @return bool Whether the name is relative
+     */
+    public function isRelative(): bool {
+        return false;
+    }
+
+    /**
+     * Returns a string representation of the name itself, without taking the name type into
+     * account (e.g., not including a leading backslash for fully qualified names).
+     *
+     * @return string String representation
+     */
+    public function toString(): string {
+        return $this->name;
+    }
+
+    /**
+     * Returns a string representation of the name as it would occur in code (e.g., including
+     * leading backslash for fully qualified names.
+     *
+     * @return string String representation
+     */
+    public function toCodeString(): string {
+        return $this->toString();
+    }
+
+    /**
+     * Returns lowercased string representation of the name, without taking the name type into
+     * account (e.g., no leading backslash for fully qualified names).
+     *
+     * @return string Lowercased string representation
+     */
+    public function toLowerString(): string {
+        return strtolower($this->name);
+    }
+
+    /**
+     * Checks whether the identifier is a special class name (self, parent or static).
+     *
+     * @return bool Whether identifier is a special class name
+     */
+    public function isSpecialClassName(): bool {
+        return isset(self::$specialClassNames[strtolower($this->name)]);
+    }
+
+    /**
+     * Returns a string representation of the name by imploding the namespace parts with the
+     * namespace separator.
+     *
+     * @return string String representation
+     */
+    public function __toString(): string {
+        return $this->name;
+    }
+
+    /**
+     * Gets a slice of a name (similar to array_slice).
+     *
+     * This method returns a new instance of the same type as the original and with the same
+     * attributes.
+     *
+     * If the slice is empty, null is returned. The null value will be correctly handled in
+     * concatenations using concat().
+     *
+     * Offset and length have the same meaning as in array_slice().
+     *
+     * @param int $offset Offset to start the slice at (may be negative)
+     * @param int|null $length Length of the slice (may be negative)
+     *
+     * @return static|null Sliced name
+     */
+    public function slice(int $offset, ?int $length = null) {
+        if ($offset === 1 && $length === null) {
+            // Short-circuit the common case.
+            if (false !== $pos = \strpos($this->name, '\\')) {
+                return new static(\substr($this->name, $pos + 1));
+            }
+            return null;
+        }
+
+        $parts = \explode('\\', $this->name);
+        $numParts = \count($parts);
+
+        $realOffset = $offset < 0 ? $offset + $numParts : $offset;
+        if ($realOffset < 0 || $realOffset > $numParts) {
+            throw new \OutOfBoundsException(sprintf('Offset %d is out of bounds', $offset));
+        }
+
+        if (null === $length) {
+            $realLength = $numParts - $realOffset;
+        } else {
+            $realLength = $length < 0 ? $length + $numParts - $realOffset : $length;
+            if ($realLength < 0 || $realLength > $numParts - $realOffset) {
+                throw new \OutOfBoundsException(sprintf('Length %d is out of bounds', $length));
+            }
+        }
+
+        if ($realLength === 0) {
+            // Empty slice is represented as null
+            return null;
+        }
+
+        return new static(array_slice($parts, $realOffset, $realLength), $this->attributes);
+    }
+
+    /**
+     * Concatenate two names, yielding a new Name instance.
+     *
+     * The type of the generated instance depends on which class this method is called on, for
+     * example Name\FullyQualified::concat() will yield a Name\FullyQualified instance.
+     *
+     * If one of the arguments is null, a new instance of the other name will be returned. If both
+     * arguments are null, null will be returned. As such, writing
+     *     Name::concat($namespace, $shortName)
+     * where $namespace is a Name node or null will work as expected.
+     *
+     * @param string|string[]|self|null $name1 The first name
+     * @param string|string[]|self|null $name2 The second name
+     * @param array<string, mixed> $attributes Attributes to assign to concatenated name
+     *
+     * @return static|null Concatenated name
+     */
+    public static function concat($name1, $name2, array $attributes = []) {
+        if (null === $name1 && null === $name2) {
+            return null;
+        }
+        if (null === $name1) {
+            return new static($name2, $attributes);
+        }
+        if (null === $name2) {
+            return new static($name1, $attributes);
+        } else {
+            return new static(
+                self::prepareName($name1) . '\\' . self::prepareName($name2), $attributes
+            );
+        }
+    }
+
+    /**
+     * Prepares a (string, array or Name node) name for use in name changing methods by converting
+     * it to a string.
+     *
+     * @param string|string[]|self $name Name to prepare
+     *
+     * @return string Prepared name
+     */
+    private static function prepareName($name): string {
+        if (\is_string($name)) {
+            if ('' === $name) {
+                throw new \InvalidArgumentException('Name cannot be empty');
+            }
+
+            return $name;
+        }
+        if (\is_array($name)) {
+            if (empty($name)) {
+                throw new \InvalidArgumentException('Name cannot be empty');
+            }
+
+            return implode('\\', $name);
+        }
+        if ($name instanceof self) {
+            return $name->name;
+        }
+
+        throw new \InvalidArgumentException(
+            'Expected string, array of parts or Name instance'
+        );
+    }
+
+    public function getType(): string {
+        return 'Name';
+    }
+}

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

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

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

@@ -0,0 +1,84 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+use PhpParser\Modifiers;
+use PhpParser\Node;
+use PhpParser\NodeAbstract;
+
+class Param extends NodeAbstract {
+    /** @var null|Identifier|Name|ComplexType Type declaration */
+    public ?Node $type;
+    /** @var bool Whether parameter is passed by reference */
+    public bool $byRef;
+    /** @var bool Whether this is a variadic argument */
+    public bool $variadic;
+    /** @var Expr\Variable|Expr\Error Parameter variable */
+    public Expr $var;
+    /** @var null|Expr Default value */
+    public ?Expr $default;
+    /** @var int Optional visibility flags */
+    public int $flags;
+    /** @var AttributeGroup[] PHP attribute groups */
+    public array $attrGroups;
+
+    /**
+     * Constructs a parameter node.
+     *
+     * @param Expr\Variable|Expr\Error $var Parameter variable
+     * @param null|Expr $default Default value
+     * @param null|Identifier|Name|ComplexType $type Type declaration
+     * @param bool $byRef Whether is passed by reference
+     * @param bool $variadic Whether this is a variadic argument
+     * @param array<string, mixed> $attributes Additional attributes
+     * @param int $flags Optional visibility flags
+     * @param list<AttributeGroup> $attrGroups PHP attribute groups
+     */
+    public function __construct(
+        Expr $var, ?Expr $default = null, ?Node $type = null,
+        bool $byRef = false, bool $variadic = false,
+        array $attributes = [],
+        int $flags = 0,
+        array $attrGroups = []
+    ) {
+        $this->attributes = $attributes;
+        $this->type = $type;
+        $this->byRef = $byRef;
+        $this->variadic = $variadic;
+        $this->var = $var;
+        $this->default = $default;
+        $this->flags = $flags;
+        $this->attrGroups = $attrGroups;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['attrGroups', 'flags', 'type', 'byRef', 'variadic', 'var', 'default'];
+    }
+
+    public function getType(): string {
+        return 'Param';
+    }
+
+    /**
+     * Whether this parameter uses constructor property promotion.
+     */
+    public function isPromoted(): bool {
+        return $this->flags !== 0;
+    }
+
+    public function isPublic(): bool {
+        return (bool) ($this->flags & Modifiers::PUBLIC);
+    }
+
+    public function isProtected(): bool {
+        return (bool) ($this->flags & Modifiers::PROTECTED);
+    }
+
+    public function isPrivate(): bool {
+        return (bool) ($this->flags & Modifiers::PRIVATE);
+    }
+
+    public function isReadonly(): bool {
+        return (bool) ($this->flags & Modifiers::READONLY);
+    }
+}

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

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node;
+
+use PhpParser\Node;
+use PhpParser\NodeAbstract;
+
+class PropertyItem extends NodeAbstract {
+    /** @var Node\VarLikeIdentifier Name */
+    public VarLikeIdentifier $name;
+    /** @var null|Node\Expr Default */
+    public ?Expr $default;
+
+    /**
+     * Constructs a class property item node.
+     *
+     * @param string|Node\VarLikeIdentifier $name Name
+     * @param null|Node\Expr $default Default value
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct($name, ?Node\Expr $default = null, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->name = \is_string($name) ? new Node\VarLikeIdentifier($name) : $name;
+        $this->default = $default;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['name', 'default'];
+    }
+
+    public function getType(): string {
+        return 'PropertyItem';
+    }
+}
+
+// @deprecated compatibility alias
+class_alias(PropertyItem::class, Stmt\PropertyProperty::class);

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

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

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

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

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

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

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

@@ -0,0 +1,78 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Scalar;
+
+use PhpParser\Node\Scalar;
+
+class Float_ extends Scalar {
+    /** @var float Number value */
+    public float $value;
+
+    /**
+     * Constructs a float number scalar node.
+     *
+     * @param float $value Value of the number
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(float $value, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->value = $value;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['value'];
+    }
+
+    /**
+     * @param mixed[] $attributes
+     */
+    public static function fromString(string $str, array $attributes = []): Float_ {
+        $attributes['rawValue'] = $str;
+        $float = self::parse($str);
+
+        return new Float_($float, $attributes);
+    }
+
+    /**
+     * @internal
+     *
+     * Parses a DNUMBER token like PHP would.
+     *
+     * @param string $str A string number
+     *
+     * @return float The parsed number
+     */
+    public static function parse(string $str): float {
+        $str = str_replace('_', '', $str);
+
+        // Check whether this is one of the special integer notations.
+        if ('0' === $str[0]) {
+            // hex
+            if ('x' === $str[1] || 'X' === $str[1]) {
+                return hexdec($str);
+            }
+
+            // bin
+            if ('b' === $str[1] || 'B' === $str[1]) {
+                return bindec($str);
+            }
+
+            // oct, but only if the string does not contain any of '.eE'.
+            if (false === strpbrk($str, '.eE')) {
+                // substr($str, 0, strcspn($str, '89')) cuts the string at the first invalid digit
+                // (8 or 9) so that only the digits before that are used.
+                return octdec(substr($str, 0, strcspn($str, '89')));
+            }
+        }
+
+        // dec
+        return (float) $str;
+    }
+
+    public function getType(): string {
+        return 'Scalar_Float';
+    }
+}
+
+// @deprecated compatibility alias
+class_alias(Float_::class, DNumber::class);

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

@@ -0,0 +1,82 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Scalar;
+
+use PhpParser\Error;
+use PhpParser\Node\Scalar;
+
+class Int_ extends Scalar {
+    /* For use in "kind" attribute */
+    public const KIND_BIN = 2;
+    public const KIND_OCT = 8;
+    public const KIND_DEC = 10;
+    public const KIND_HEX = 16;
+
+    /** @var int Number value */
+    public int $value;
+
+    /**
+     * Constructs an integer number scalar node.
+     *
+     * @param int $value Value of the number
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(int $value, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->value = $value;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['value'];
+    }
+
+    /**
+     * Constructs an Int node from a string number literal.
+     *
+     * @param string $str String number literal (decimal, octal, hex or binary)
+     * @param array<string, mixed> $attributes Additional attributes
+     * @param bool $allowInvalidOctal Whether to allow invalid octal numbers (PHP 5)
+     *
+     * @return Int_ The constructed LNumber, including kind attribute
+     */
+    public static function fromString(string $str, array $attributes = [], bool $allowInvalidOctal = false): Int_ {
+        $attributes['rawValue'] = $str;
+
+        $str = str_replace('_', '', $str);
+
+        if ('0' !== $str[0] || '0' === $str) {
+            $attributes['kind'] = Int_::KIND_DEC;
+            return new Int_((int) $str, $attributes);
+        }
+
+        if ('x' === $str[1] || 'X' === $str[1]) {
+            $attributes['kind'] = Int_::KIND_HEX;
+            return new Int_(hexdec($str), $attributes);
+        }
+
+        if ('b' === $str[1] || 'B' === $str[1]) {
+            $attributes['kind'] = Int_::KIND_BIN;
+            return new Int_(bindec($str), $attributes);
+        }
+
+        if (!$allowInvalidOctal && strpbrk($str, '89')) {
+            throw new Error('Invalid numeric literal', $attributes);
+        }
+
+        // Strip optional explicit octal prefix.
+        if ('o' === $str[1] || 'O' === $str[1]) {
+            $str = substr($str, 2);
+        }
+
+        // use intval instead of octdec to get proper cutting behavior with malformed numbers
+        $attributes['kind'] = Int_::KIND_OCT;
+        return new Int_(intval($str, 8), $attributes);
+    }
+
+    public function getType(): string {
+        return 'Scalar_Int';
+    }
+}
+
+// @deprecated compatibility alias
+class_alias(Int_::class, LNumber::class);

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

@@ -0,0 +1,34 @@
+<?php declare(strict_types=1);
+
+namespace PhpParser\Node\Scalar;
+
+use PhpParser\Node\Expr;
+use PhpParser\Node\InterpolatedStringPart;
+use PhpParser\Node\Scalar;
+
+class InterpolatedString extends Scalar {
+    /** @var (Expr|InterpolatedStringPart)[] list of string parts */
+    public array $parts;
+
+    /**
+     * Constructs an interpolated string node.
+     *
+     * @param (Expr|InterpolatedStringPart)[] $parts Interpolated string parts
+     * @param array<string, mixed> $attributes Additional attributes
+     */
+    public function __construct(array $parts, array $attributes = []) {
+        $this->attributes = $attributes;
+        $this->parts = $parts;
+    }
+
+    public function getSubNodeNames(): array {
+        return ['parts'];
+    }
+
+    public function getType(): string {
+        return 'Scalar_InterpolatedString';
+    }
+}
+
+// @deprecated compatibility alias
+class_alias(InterpolatedString::class, Encapsed::class);

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

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