first commit

This commit is contained in:
CHIEFSOFT\ameye
2025-11-22 09:54:51 -05:00
commit 07a07ab49f
722 changed files with 125787 additions and 0 deletions
@@ -0,0 +1,65 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
abstract class AbstractRepresentation implements RepresentationInterface
{
/** @psalm-readonly */
protected string $label;
/** @psalm-readonly */
protected string $name;
/** @psalm-readonly */
protected bool $implicit_label;
public function __construct(string $label, ?string $name = null, bool $implicit_label = false)
{
$this->label = $label;
$this->name = \preg_replace('/[^a-z0-9]+/', '_', \strtolower($name ?? $label));
$this->implicit_label = $implicit_label;
}
public function getLabel(): string
{
return $this->label;
}
public function getName(): string
{
return $this->name;
}
public function labelIsImplicit(): bool
{
return $this->implicit_label;
}
public function getHint(): ?string
{
return null;
}
}
@@ -0,0 +1,50 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
class BinaryRepresentation extends AbstractRepresentation
{
/** @psalm-readonly */
protected string $value;
public function __construct(string $value, bool $implicit = false)
{
parent::__construct('Hex dump', 'binary', $implicit);
$this->value = $value;
}
public function getHint(): string
{
return 'binary';
}
public function getValue(): string
{
return $this->value;
}
}
@@ -0,0 +1,157 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use InvalidArgumentException;
class CallableDefinitionRepresentation extends AbstractRepresentation
{
/** @psalm-readonly */
protected string $filename;
/** @psalm-readonly */
protected int $line;
/**
* @psalm-readonly
*
* @psalm-var ?non-empty-string
*/
protected ?string $docstring;
/**
* @psalm-param ?non-empty-string $docstring
*/
public function __construct(string $filename, int $line, ?string $docstring)
{
if (null !== $docstring && !\preg_match('%^/\\*\\*.+\\*/$%s', $docstring)) {
throw new InvalidArgumentException('Docstring is invalid');
}
parent::__construct('Callable definition', null, true);
$this->filename = $filename;
$this->line = $line;
$this->docstring = $docstring;
}
public function getHint(): string
{
return 'callable';
}
public function getFileName(): string
{
return $this->filename;
}
public function getLine(): int
{
return $this->line;
}
/**
* @psalm-api
*
* @psalm-return ?non-empty-string
*/
public function getDocstring(): ?string
{
return $this->docstring;
}
/**
* Returns the representation's docstring without surrounding comments.
*
* Note that this will not work flawlessly.
*
* On comments with whitespace after the stars the lines will begin with
* whitespace, since we can't accurately guess how much of an indentation
* is required.
*
* And on lines without stars on the left this may eat bullet points.
*
* Long story short: If you want the docstring read the contents. If you
* absolutely must have it without comments (ie renderValueShort) this will
* probably do.
*/
public function getDocstringWithoutComments(): ?string
{
if (null === ($ds = $this->getDocstring())) {
return null;
}
$string = \substr($ds, 3, -2);
$string = \preg_replace('/^\\s*\\*\\s*?(\\S|$)/m', '\\1', $string);
return \trim($string);
}
public function getDocstringFirstLine(): ?string
{
$ds = $this->getDocstringWithoutComments();
if (null === $ds) {
return null;
}
$ds = \explode("\n", $ds);
$out = '';
foreach ($ds as $line) {
if (0 === \strlen(\trim($line)) || '@' === $line[0]) {
break;
}
$out .= $line.' ';
}
if (\strlen($out)) {
return \rtrim($out);
}
return null;
}
public function getDocstringTrimmed(): ?string
{
if (null === ($ds = $this->getDocstring())) {
return null;
}
$docstring = [];
foreach (\explode("\n", $ds) as $line) {
$line = \trim($line);
if (($line[0] ?? null) === '*') {
$line = ' '.$line;
}
$docstring[] = $line;
}
return \implode("\n", $docstring);
}
}
@@ -0,0 +1,594 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use InvalidArgumentException;
use LogicException;
class ColorRepresentation extends AbstractRepresentation
{
public const COLOR_NAME = 1;
public const COLOR_HEX_3 = 2;
public const COLOR_HEX_6 = 3;
public const COLOR_RGB = 4;
public const COLOR_RGBA = 5;
public const COLOR_HSL = 6;
public const COLOR_HSLA = 7;
public const COLOR_HEX_4 = 8;
public const COLOR_HEX_8 = 9;
/** @psalm-var array<truthy-string, truthy-string> */
public static array $color_map = [
'aliceblue' => 'f0f8ff',
'antiquewhite' => 'faebd7',
'aqua' => '00ffff',
'aquamarine' => '7fffd4',
'azure' => 'f0ffff',
'beige' => 'f5f5dc',
'bisque' => 'ffe4c4',
'black' => '000000',
'blanchedalmond' => 'ffebcd',
'blue' => '0000ff',
'blueviolet' => '8a2be2',
'brown' => 'a52a2a',
'burlywood' => 'deb887',
'cadetblue' => '5f9ea0',
'chartreuse' => '7fff00',
'chocolate' => 'd2691e',
'coral' => 'ff7f50',
'cornflowerblue' => '6495ed',
'cornsilk' => 'fff8dc',
'crimson' => 'dc143c',
'cyan' => '00ffff',
'darkblue' => '00008b',
'darkcyan' => '008b8b',
'darkgoldenrod' => 'b8860b',
'darkgray' => 'a9a9a9',
'darkgreen' => '006400',
'darkgrey' => 'a9a9a9',
'darkkhaki' => 'bdb76b',
'darkmagenta' => '8b008b',
'darkolivegreen' => '556b2f',
'darkorange' => 'ff8c00',
'darkorchid' => '9932cc',
'darkred' => '8b0000',
'darksalmon' => 'e9967a',
'darkseagreen' => '8fbc8f',
'darkslateblue' => '483d8b',
'darkslategray' => '2f4f4f',
'darkslategrey' => '2f4f4f',
'darkturquoise' => '00ced1',
'darkviolet' => '9400d3',
'deeppink' => 'ff1493',
'deepskyblue' => '00bfff',
'dimgray' => '696969',
'dimgrey' => '696969',
'dodgerblue' => '1e90ff',
'firebrick' => 'b22222',
'floralwhite' => 'fffaf0',
'forestgreen' => '228b22',
'fuchsia' => 'ff00ff',
'gainsboro' => 'dcdcdc',
'ghostwhite' => 'f8f8ff',
'gold' => 'ffd700',
'goldenrod' => 'daa520',
'gray' => '808080',
'green' => '008000',
'greenyellow' => 'adff2f',
'grey' => '808080',
'honeydew' => 'f0fff0',
'hotpink' => 'ff69b4',
'indianred' => 'cd5c5c',
'indigo' => '4b0082',
'ivory' => 'fffff0',
'khaki' => 'f0e68c',
'lavender' => 'e6e6fa',
'lavenderblush' => 'fff0f5',
'lawngreen' => '7cfc00',
'lemonchiffon' => 'fffacd',
'lightblue' => 'add8e6',
'lightcoral' => 'f08080',
'lightcyan' => 'e0ffff',
'lightgoldenrodyellow' => 'fafad2',
'lightgray' => 'd3d3d3',
'lightgreen' => '90ee90',
'lightgrey' => 'd3d3d3',
'lightpink' => 'ffb6c1',
'lightsalmon' => 'ffa07a',
'lightseagreen' => '20b2aa',
'lightskyblue' => '87cefa',
'lightslategray' => '778899',
'lightslategrey' => '778899',
'lightsteelblue' => 'b0c4de',
'lightyellow' => 'ffffe0',
'lime' => '00ff00',
'limegreen' => '32cd32',
'linen' => 'faf0e6',
'magenta' => 'ff00ff',
'maroon' => '800000',
'mediumaquamarine' => '66cdaa',
'mediumblue' => '0000cd',
'mediumorchid' => 'ba55d3',
'mediumpurple' => '9370db',
'mediumseagreen' => '3cb371',
'mediumslateblue' => '7b68ee',
'mediumspringgreen' => '00fa9a',
'mediumturquoise' => '48d1cc',
'mediumvioletred' => 'c71585',
'midnightblue' => '191970',
'mintcream' => 'f5fffa',
'mistyrose' => 'ffe4e1',
'moccasin' => 'ffe4b5',
'navajowhite' => 'ffdead',
'navy' => '000080',
'oldlace' => 'fdf5e6',
'olive' => '808000',
'olivedrab' => '6b8e23',
'orange' => 'ffa500',
'orangered' => 'ff4500',
'orchid' => 'da70d6',
'palegoldenrod' => 'eee8aa',
'palegreen' => '98fb98',
'paleturquoise' => 'afeeee',
'palevioletred' => 'db7093',
'papayawhip' => 'ffefd5',
'peachpuff' => 'ffdab9',
'peru' => 'cd853f',
'pink' => 'ffc0cb',
'plum' => 'dda0dd',
'powderblue' => 'b0e0e6',
'purple' => '800080',
'rebeccapurple' => '663399',
'red' => 'ff0000',
'rosybrown' => 'bc8f8f',
'royalblue' => '4169e1',
'saddlebrown' => '8b4513',
'salmon' => 'fa8072',
'sandybrown' => 'f4a460',
'seagreen' => '2e8b57',
'seashell' => 'fff5ee',
'sienna' => 'a0522d',
'silver' => 'c0c0c0',
'skyblue' => '87ceeb',
'slateblue' => '6a5acd',
'slategray' => '708090',
'slategrey' => '708090',
'snow' => 'fffafa',
'springgreen' => '00ff7f',
'steelblue' => '4682b4',
'tan' => 'd2b48c',
'teal' => '008080',
'thistle' => 'd8bfd8',
'tomato' => 'ff6347',
// To quote MDN:
// "Technically, transparent is a shortcut for rgba(0,0,0,0)."
'transparent' => '00000000',
'turquoise' => '40e0d0',
'violet' => 'ee82ee',
'wheat' => 'f5deb3',
'white' => 'ffffff',
'whitesmoke' => 'f5f5f5',
'yellow' => 'ffff00',
'yellowgreen' => '9acd32',
];
protected int $r;
protected int $g;
protected int $b;
protected float $a;
/** @psalm-var self::COLOR_* */
protected int $variant;
public function __construct(string $value)
{
parent::__construct('Color', null, true);
$this->setValues($value);
}
public function getHint(): string
{
return 'color';
}
/**
* @psalm-api
*
* @psalm-return self::COLOR_*
*/
public function getVariant(): int
{
return $this->variant;
}
/**
* @psalm-param self::COLOR_* $variant
*
* @psalm-return ?truthy-string
*/
public function getColor(?int $variant = null): ?string
{
$variant ??= $this->variant;
switch ($variant) {
case self::COLOR_NAME:
$hex = \sprintf('%02x%02x%02x', $this->r, $this->g, $this->b);
$hex_alpha = \sprintf('%02x%02x%02x%02x', $this->r, $this->g, $this->b, \round($this->a * 0xFF));
return \array_search($hex, self::$color_map, true) ?: \array_search($hex_alpha, self::$color_map, true) ?: null;
case self::COLOR_HEX_3:
if (0 === $this->r % 0x11 && 0 === $this->g % 0x11 && 0 === $this->b % 0x11) {
/** @psalm-var truthy-string */
return \sprintf(
'#%1X%1X%1X',
\round($this->r / 0x11),
\round($this->g / 0x11),
\round($this->b / 0x11)
);
}
return null;
case self::COLOR_HEX_6:
/** @psalm-var truthy-string */
return \sprintf('#%02X%02X%02X', $this->r, $this->g, $this->b);
case self::COLOR_RGB:
if (1.0 === $this->a) {
/** @psalm-var truthy-string */
return \sprintf('rgb(%d, %d, %d)', $this->r, $this->g, $this->b);
}
/** @psalm-var truthy-string */
return \sprintf('rgb(%d, %d, %d, %s)', $this->r, $this->g, $this->b, \round($this->a, 4));
case self::COLOR_RGBA:
/** @psalm-var truthy-string */
return \sprintf('rgba(%d, %d, %d, %s)', $this->r, $this->g, $this->b, \round($this->a, 4));
case self::COLOR_HSL:
$val = self::rgbToHsl($this->r, $this->g, $this->b);
$val[1] = \round($val[1] * 100);
$val[2] = \round($val[2] * 100);
if (1.0 === $this->a) {
/** @psalm-var truthy-string */
return \vsprintf('hsl(%d, %d%%, %d%%)', $val);
}
/** @psalm-var truthy-string */
return \sprintf('hsl(%d, %d%%, %d%%, %s)', $val[0], $val[1], $val[2], \round($this->a, 4));
case self::COLOR_HSLA:
$val = self::rgbToHsl($this->r, $this->g, $this->b);
$val[1] = \round($val[1] * 100);
$val[2] = \round($val[2] * 100);
/** @psalm-var truthy-string */
return \sprintf('hsla(%d, %d%%, %d%%, %s)', $val[0], $val[1], $val[2], \round($this->a, 4));
case self::COLOR_HEX_4:
if (0 === $this->r % 0x11 && 0 === $this->g % 0x11 && 0 === $this->b % 0x11 && 0 === ((int) ($this->a * 255)) % 0x11) {
/** @psalm-var truthy-string */
return \sprintf(
'#%1X%1X%1X%1X',
\round($this->r / 0x11),
\round($this->g / 0x11),
\round($this->b / 0x11),
\round($this->a * 0xF)
);
}
return null;
case self::COLOR_HEX_8:
/** @psalm-var truthy-string */
return \sprintf('#%02X%02X%02X%02X', $this->r, $this->g, $this->b, \round($this->a * 0xFF));
}
return null;
}
public function hasAlpha(?int $variant = null): bool
{
$variant ??= $this->variant;
switch ($variant) {
case self::COLOR_NAME:
case self::COLOR_RGB:
case self::COLOR_HSL:
return \abs($this->a - 1) >= 0.0001;
case self::COLOR_RGBA:
case self::COLOR_HSLA:
case self::COLOR_HEX_4:
case self::COLOR_HEX_8:
return true;
default:
return false;
}
}
protected function setValues(string $value): void
{
$this->a = 1.0;
$value = \strtolower(\trim($value));
// Find out which variant of color input it is
if (isset(self::$color_map[$value])) {
$this->setValuesFromHex(self::$color_map[$value]);
$variant = self::COLOR_NAME;
} elseif ('#' === $value[0]) {
$variant = $this->setValuesFromHex(\substr($value, 1));
} else {
$variant = $this->setValuesFromFunction($value);
}
// If something has gone horribly wrong
if ($this->r > 0xFF || $this->g > 0xFF || $this->b > 0xFF || $this->a > 1) {
throw new LogicException('Something has gone wrong with color parsing'); // @codeCoverageIgnore
}
$this->variant = $variant;
}
/** @psalm-return self::COLOR_* */
protected function setValuesFromHex(string $hex): int
{
if (!\ctype_xdigit($hex)) {
throw new InvalidArgumentException('Hex color codes must be hexadecimal');
}
switch (\strlen($hex)) {
case 3:
$variant = self::COLOR_HEX_3;
break;
case 6:
$variant = self::COLOR_HEX_6;
break;
case 4:
$variant = self::COLOR_HEX_4;
break;
case 8:
$variant = self::COLOR_HEX_8;
break;
default:
throw new InvalidArgumentException('Hex color codes must have 3, 4, 6, or 8 characters');
}
switch ($variant) {
case self::COLOR_HEX_4:
$this->a = \hexdec($hex[3]) / 0xF;
// no break
case self::COLOR_HEX_3:
$this->r = \hexdec($hex[0]) * 0x11;
$this->g = \hexdec($hex[1]) * 0x11;
$this->b = \hexdec($hex[2]) * 0x11;
break;
case self::COLOR_HEX_8:
$this->a = \hexdec(\substr($hex, 6, 2)) / 0xFF;
// no break
case self::COLOR_HEX_6:
$hex = \str_split($hex, 2);
$this->r = \hexdec($hex[0]);
$this->g = \hexdec($hex[1]);
$this->b = \hexdec($hex[2]);
break;
}
return $variant;
}
/** @psalm-return self::COLOR_* */
protected function setValuesFromFunction(string $value): int
{
if (!\preg_match('/^((?:rgb|hsl)a?)\\s*\\(([0-9\\.%,\\s\\/\\-]+)\\)$/i', $value, $match)) {
throw new InvalidArgumentException('Couldn\'t parse color function string');
}
switch (\strtolower($match[1])) {
case 'rgb':
$variant = self::COLOR_RGB;
break;
case 'rgba':
$variant = self::COLOR_RGBA;
break;
case 'hsl':
$variant = self::COLOR_HSL;
break;
case 'hsla':
$variant = self::COLOR_HSLA;
break;
default:
// The regex should preclude this from ever happening
throw new InvalidArgumentException('Color functions must be one of rgb/rgba/hsl/hsla'); // @codeCoverageIgnore
}
$params = \preg_replace('/[,\\s\\/]+/', ',', \trim($match[2]));
$params = \explode(',', $params);
$params = \array_map('trim', $params);
if (\count($params) < 3 || \count($params) > 4) {
throw new InvalidArgumentException('Color functions must have 3 or 4 arguments');
}
foreach ($params as $i => &$color) {
if (false !== \strpos($color, '%')) {
$color = (float) \str_replace('%', '', $color);
if (\in_array($variant, [self::COLOR_RGB, self::COLOR_RGBA], true) && 3 !== $i) {
$color = \round($color / 100 * 0xFF);
} else {
$color = $color / 100;
}
}
$color = (float) $color;
if (0 === $i && \in_array($variant, [self::COLOR_HSL, self::COLOR_HSLA], true)) {
$color = \fmod(\fmod($color, 360) + 360, 360);
}
}
/**
* @psalm-var non-empty-array<array-key, float> $params
* Psalm bug #746 (wontfix)
*/
switch ($variant) {
case self::COLOR_RGBA:
case self::COLOR_RGB:
if (\min($params) < 0 || \max($params) > 0xFF) {
throw new InvalidArgumentException('RGB function arguments must be between 0 and 255');
}
break;
case self::COLOR_HSLA:
case self::COLOR_HSL:
if ($params[0] < 0 || $params[0] > 360) {
// Should be impossible because of the fmod work
throw new InvalidArgumentException('Hue must be between 0 and 360'); // @codeCoverageIgnore
}
if (\min($params) < 0 || \max($params[1], $params[2]) > 1) {
throw new InvalidArgumentException('Saturation/lightness must be between 0 and 1');
}
break;
}
if (4 === \count($params)) {
if ($params[3] > 1) {
throw new InvalidArgumentException('Alpha must be between 0 and 1');
}
$this->a = $params[3];
}
if (self::COLOR_HSLA === $variant || self::COLOR_HSL === $variant) {
$params = self::hslToRgb($params[0], $params[1], $params[2]);
}
[$this->r, $this->g, $this->b] = [(int) $params[0], (int) $params[1], (int) $params[2]];
return $variant;
}
/**
* Turns HSL color to RGB. Black magic.
*
* @param float $h Hue
* @param float $s Saturation
* @param float $l Lightness
*
* @return int[] RGB array
*/
public static function hslToRgb(float $h, float $s, float $l): array
{
if (\min($h, $s, $l) < 0) {
throw new InvalidArgumentException('The parameters for hslToRgb should be no less than 0');
}
if ($h > 360 || \max($s, $l) > 1) {
throw new InvalidArgumentException('The parameters for hslToRgb should be no more than 360, 1, and 1 respectively');
}
$h /= 360;
$m2 = ($l <= 0.5) ? $l * ($s + 1) : $l + $s - $l * $s;
$m1 = $l * 2 - $m2;
return [
(int) \round(self::hueToRgb($m1, $m2, $h + 1 / 3) * 0xFF),
(int) \round(self::hueToRgb($m1, $m2, $h) * 0xFF),
(int) \round(self::hueToRgb($m1, $m2, $h - 1 / 3) * 0xFF),
];
}
/**
* Converts RGB to HSL. Color inversion of previous black magic is white magic?
*
* @param float $red Red
* @param float $green Green
* @param float $blue Blue
*
* @return float[] HSL array
*/
public static function rgbToHsl(float $red, float $green, float $blue): array
{
if (\min($red, $green, $blue) < 0) {
throw new InvalidArgumentException('The parameters for rgbToHsl should be no less than 0');
}
if (\max($red, $green, $blue) > 0xFF) {
throw new InvalidArgumentException('The parameters for rgbToHsl should be no more than 255');
}
$clrMin = \min($red, $green, $blue);
$clrMax = \max($red, $green, $blue);
$deltaMax = $clrMax - $clrMin;
$L = ($clrMax + $clrMin) / 510;
if (0 == $deltaMax) {
$H = 0.0;
$S = 0.0;
} else {
if (0.5 > $L) {
$S = $deltaMax / ($clrMax + $clrMin);
} else {
$S = $deltaMax / (510 - $clrMax - $clrMin);
}
if ($clrMax === $red) {
$H = ($green - $blue) / (6.0 * $deltaMax);
if (0 > $H) {
$H += 1.0;
}
} elseif ($clrMax === $green) {
$H = 1 / 3 + ($blue - $red) / (6.0 * $deltaMax);
} else {
$H = 2 / 3 + ($red - $green) / (6.0 * $deltaMax);
}
}
return [
\fmod($H * 360, 360),
$S,
$L,
];
}
/**
* Helper function for hslToRgb. Even blacker magic.
*
* @return float Color value
*/
private static function hueToRgb(float $m1, float $m2, float $hue): float
{
$hue = ($hue < 0) ? $hue + 1 : (($hue > 1) ? $hue - 1 : $hue);
if ($hue * 6 < 1) {
return $m1 + ($m2 - $m1) * $hue * 6;
}
if ($hue * 2 < 1) {
return $m2;
}
if ($hue * 3 < 2) {
return $m1 + ($m2 - $m1) * (2 / 3 - $hue) * 6;
}
return $m1;
}
}
@@ -0,0 +1,63 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use InvalidArgumentException;
use Kint\Value\AbstractValue;
class ContainerRepresentation extends AbstractRepresentation
{
/**
* @psalm-readonly
*
* @psalm-var non-empty-array<AbstractValue>
*/
protected array $contents;
/** @psalm-param non-empty-array<AbstractValue> $contents */
public function __construct(string $label, array $contents, ?string $name = null, bool $implicit_label = false)
{
if ([] === $contents) {
throw new InvalidArgumentException("ContainerRepresentation can't take empty list");
}
parent::__construct($label, $name, $implicit_label);
$this->contents = $contents;
}
/** @psalm-return non-empty-array<AbstractValue> */
public function getContents(): array
{
return $this->contents;
}
public function getLabel(): string
{
return parent::getLabel().' ('.\count($this->contents).')';
}
}
@@ -0,0 +1,125 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use DateTimeImmutable;
use DateTimeInterface;
class MicrotimeRepresentation extends AbstractRepresentation
{
/** @psalm-readonly */
protected int $seconds;
/** @psalm-readonly */
protected int $microseconds;
/** @psalm-readonly */
protected string $group;
/** @psalm-readonly */
protected ?float $lap_time;
/** @psalm-readonly */
protected ?float $total_time;
protected ?float $avg_time = null;
/** @psalm-readonly */
protected int $mem;
/** @psalm-readonly */
protected int $mem_real;
/** @psalm-readonly */
protected int $mem_peak;
/** @psalm-readonly */
protected int $mem_peak_real;
public function __construct(int $seconds, int $microseconds, string $group, ?float $lap_time = null, ?float $total_time = null, int $i = 0)
{
parent::__construct('Microtime', null, true);
$this->seconds = $seconds;
$this->microseconds = $microseconds;
$this->group = $group;
$this->lap_time = $lap_time;
$this->total_time = $total_time;
if ($i > 0) {
$this->avg_time = $total_time / $i;
}
$this->mem = \memory_get_usage();
$this->mem_real = \memory_get_usage(true);
$this->mem_peak = \memory_get_peak_usage();
$this->mem_peak_real = \memory_get_peak_usage(true);
}
public function getHint(): string
{
return 'microtime';
}
public function getGroup(): string
{
return $this->group;
}
public function getLapTime(): ?float
{
return $this->lap_time;
}
public function getTotalTime(): ?float
{
return $this->total_time;
}
public function getAverageTime(): ?float
{
return $this->avg_time;
}
public function getMemoryUsage(): int
{
return $this->mem;
}
public function getMemoryUsageReal(): int
{
return $this->mem_real;
}
public function getMemoryPeakUsage(): int
{
return $this->mem_peak;
}
public function getMemoryPeakUsageReal(): int
{
return $this->mem_peak_real;
}
public function getDateTime(): ?DateTimeInterface
{
return DateTimeImmutable::createFromFormat('U u', $this->seconds.' '.\str_pad((string) $this->microseconds, 6, '0', STR_PAD_LEFT)) ?: null;
}
}
@@ -0,0 +1,47 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
class ProfileRepresentation extends AbstractRepresentation
{
/** @psalm-readonly */
public int $complexity;
public ?int $instance_counts = null;
public ?int $instance_complexity = null;
public function __construct(int $complexity)
{
parent::__construct('Performance profile', 'profiling', false);
$this->complexity = $complexity;
}
public function getHint(): string
{
return 'profiling';
}
}
@@ -0,0 +1,39 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
interface RepresentationInterface
{
public function getLabel(): string;
public function getName(): string;
public function getHint(): ?string;
public function labelIsImplicit(): bool;
}
@@ -0,0 +1,121 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use RuntimeException;
class SourceRepresentation extends AbstractRepresentation
{
private const DEFAULT_PADDING = 7;
/**
* @psalm-readonly
*
* @psalm-var non-empty-array<string>
*/
protected array $source;
/** @psalm-readonly */
protected string $filename;
/** @psalm-readonly */
protected int $line;
/** @psalm-readonly */
protected bool $showfilename;
public function __construct(string $filename, int $line, ?int $padding = self::DEFAULT_PADDING, bool $showfilename = false)
{
parent::__construct('Source');
$this->filename = $filename;
$this->line = $line;
$this->showfilename = $showfilename;
$padding ??= self::DEFAULT_PADDING;
$start_line = \max($line - $padding, 1);
$length = $line + $padding + 1 - $start_line;
$this->source = self::readSource($filename, $start_line, $length);
}
public function getHint(): string
{
return 'source';
}
/**
* @psalm-api
*
* @psalm-return non-empty-string
*/
public function getSourceSlice(): string
{
return \implode("\n", $this->source);
}
/** @psalm-return non-empty-array<string> */
public function getSourceLines(): array
{
return $this->source;
}
public function getFileName(): string
{
return $this->filename;
}
public function getLine(): int
{
return $this->line;
}
public function showFileName(): bool
{
return $this->showfilename;
}
/**
* Gets section of source code.
*
* @psalm-return non-empty-array<string>
*/
private static function readSource(string $filename, int $start_line = 1, ?int $length = null): array
{
if (!$filename || !\file_exists($filename) || !\is_readable($filename)) {
throw new RuntimeException("Couldn't read file");
}
$source = \preg_split("/\r\n|\n|\r/", \file_get_contents($filename));
$source = \array_combine(\range(1, \count($source)), $source);
$source = \array_slice($source, $start_line - 1, $length, true);
if (0 === \count($source)) {
throw new RuntimeException('File seemed to be empty');
}
return $source;
}
}
@@ -0,0 +1,180 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use Kint\Utils;
use RuntimeException;
use SplFileInfo;
class SplFileInfoRepresentation extends StringRepresentation
{
public function __construct(SplFileInfo $fileInfo)
{
$path = $fileInfo->getPathname();
$perms = 0;
$owner = null;
$group = null;
$mtime = null;
$realpath = null;
$linktarget = null;
$size = null;
$is_file = false;
$is_dir = false;
$is_link = false;
$typename = 'Unknown file';
try {
// SplFileInfo::getRealPath will return cwd when path is ''
if ('' !== $path && $fileInfo->getRealPath()) {
$perms = $fileInfo->getPerms();
$size = $fileInfo->getSize();
$owner = $fileInfo->getOwner();
$group = $fileInfo->getGroup();
$mtime = $fileInfo->getMTime();
$realpath = $fileInfo->getRealPath();
}
$is_dir = $fileInfo->isDir();
$is_file = $fileInfo->isFile();
$is_link = $fileInfo->isLink();
if ($is_link) {
$lt = $fileInfo->getLinkTarget();
$linktarget = false === $lt ? null : $lt;
}
} catch (RuntimeException $e) {
if (false === \strpos($e->getMessage(), ' open_basedir ')) {
throw $e; // @codeCoverageIgnore
}
}
$typeflag = '-';
switch ($perms & 0xF000) {
case 0xC000:
$typename = 'Socket';
$typeflag = 's';
break;
case 0x6000:
$typename = 'Block device';
$typeflag = 'b';
break;
case 0x2000:
$typename = 'Character device';
$typeflag = 'c';
break;
case 0x1000:
$typename = 'Named pipe';
$typeflag = 'p';
break;
default:
if ($is_file) {
if ($is_link) {
$typename = 'File symlink';
$typeflag = 'l';
} else {
$typename = 'File';
$typeflag = '-';
}
} elseif ($is_dir) {
if ($is_link) {
$typename = 'Directory symlink';
$typeflag = 'l';
} else {
$typename = 'Directory';
$typeflag = 'd';
}
}
break;
}
$flags = [$typeflag];
// User
$flags[] = (($perms & 0400) ? 'r' : '-');
$flags[] = (($perms & 0200) ? 'w' : '-');
if ($perms & 0100) {
$flags[] = ($perms & 04000) ? 's' : 'x';
} else {
$flags[] = ($perms & 04000) ? 'S' : '-';
}
// Group
$flags[] = (($perms & 0040) ? 'r' : '-');
$flags[] = (($perms & 0020) ? 'w' : '-');
if ($perms & 0010) {
$flags[] = ($perms & 02000) ? 's' : 'x';
} else {
$flags[] = ($perms & 02000) ? 'S' : '-';
}
// Other
$flags[] = (($perms & 0004) ? 'r' : '-');
$flags[] = (($perms & 0002) ? 'w' : '-');
if ($perms & 0001) {
$flags[] = ($perms & 01000) ? 's' : 'x';
} else {
$flags[] = ($perms & 01000) ? 'S' : '-';
}
$contents = \implode($flags).' '.$owner.' '.$group.' '.$size.' ';
if (null !== $mtime) {
if (\date('Y', $mtime) === \date('Y')) {
$contents .= \date('M d H:i', $mtime);
} else {
$contents .= \date('M d Y', $mtime);
}
}
$contents .= ' ';
if ($is_link && null !== $linktarget) {
$contents .= $path.' -> '.$linktarget;
} elseif (null !== $realpath && \strlen($realpath) < \strlen($path)) {
$contents .= $realpath;
} else {
$contents .= $path;
}
$label = $typename;
if (null !== $size && $is_file) {
$size = Utils::getHumanReadableBytes($size);
$label .= ' ('.$size['value'].$size['unit'].')';
}
parent::__construct($label, $contents, 'splfileinfo');
}
public function getHint(): string
{
return 'splfileinfo';
}
}
@@ -0,0 +1,57 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use InvalidArgumentException;
class StringRepresentation extends AbstractRepresentation
{
/**
* @psalm-readonly
*
* @psalm-var non-empty-string
*/
protected string $value;
/** @psalm-assert non-empty-string $value */
public function __construct(string $label, string $value, ?string $name = null, bool $implicit = false)
{
if ('' === $value) {
throw new InvalidArgumentException("StringRepresentation can't take empty string");
}
parent::__construct($label, $name, $implicit);
$this->value = $value;
}
/** @psalm-return non-empty-string */
public function getValue(): string
{
return $this->value;
}
}
@@ -0,0 +1,44 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use Kint\Value\AbstractValue;
class TableRepresentation extends ContainerRepresentation
{
/** @psalm-param non-empty-array<AbstractValue> $contents */
public function __construct(array $contents, ?string $name = null)
{
parent::__construct('Table', $contents, $name, false);
}
public function getHint(): string
{
return 'table';
}
}
@@ -0,0 +1,47 @@
<?php
declare(strict_types=1);
/*
* The MIT License (MIT)
*
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in all
* copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*/
namespace Kint\Value\Representation;
use Kint\Value\AbstractValue;
class ValueRepresentation extends AbstractRepresentation
{
/** @psalm-readonly */
protected AbstractValue $value;
public function __construct(string $label, AbstractValue $value, ?string $name = null, bool $implicit_label = false)
{
parent::__construct($label, $name, $implicit_label);
$this->value = $value;
}
public function getValue(): AbstractValue
{
return $this->value;
}
}