Current File : //vendor/psy/psysh/src/Readline/Interactive/Renderer/LineMetrics.php
<?php
/*
* This file is part of Psy Shell.
*
* (c) 2012-2026 Justin Hileman
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace Psy\Readline\Interactive\Renderer;
use Psy\Readline\Interactive\Layout\DisplayString;
use Psy\Readline\Interactive\Layout\SoftWrapCalculator;
use Psy\Readline\Interactive\Terminal;
/**
* Soft-wrap math and line-row caching, shared by the renderer and any
* widgets that need to reason about wrapped-row geometry.
*
* Holds a single SoftWrapCalculator keyed by terminal width and a cache
* of per-line wrapped-row counts; both are invalidated automatically when
* the terminal width changes.
*/
class LineMetrics
{
private Terminal $terminal;
private ?SoftWrapCalculator $softWrapCalculator = null;
private ?int $cachedWidth = null;
/** @var array<string, int> Cached row counts keyed by line content. */
private array $rowCache = [];
public function __construct(Terminal $terminal)
{
$this->terminal = $terminal;
}
public function getTerminalWidth(): int
{
return \max(1, $this->terminal->getWidth());
}
public function softWrap(): SoftWrapCalculator
{
$width = $this->getTerminalWidth();
if ($this->softWrapCalculator === null || $this->cachedWidth !== $width) {
$this->softWrapCalculator = new SoftWrapCalculator($width);
$this->cachedWidth = $width;
$this->rowCache = [];
}
return $this->softWrapCalculator;
}
/**
* Count wrapped terminal rows for a single logical line.
*/
public function lineRowCount(string $line): int
{
// Ask for the calculator first so it can invalidate the row cache if
// the terminal width has changed since the last call.
$softWrap = $this->softWrap();
if (isset($this->rowCache[$line])) {
return $this->rowCache[$line];
}
$width = DisplayString::widthWithoutAnsi($line);
$rows = $softWrap->rowCountForDisplayWidth($width);
$this->rowCache[$line] = $rows;
return $rows;
}
/**
* Total wrapped rows occupied by a list of lines.
*
* @param string[] $lines
*/
public function frameRowCount(array $lines): int
{
$rows = 0;
foreach ($lines as $line) {
$rows += $this->lineRowCount($line);
}
return \max(1, $rows);
}
/**
* Wrapped rows occupied by lines before the given logical line index.
*
* @param string[] $lines
*/
public function rowOffsetBeforeLine(array $lines, int $lineIndex): int
{
$rows = 0;
$lineIndex = \max(0, \min($lineIndex, \count($lines)));
for ($i = 0; $i < $lineIndex; $i++) {
$rows += $this->lineRowCount($lines[$i]);
}
return $rows;
}
}
Mini Shell