<?php

declare(strict_types=1);

namespace LIT\MCP\Abilities;

defined('ABSPATH') || exit;

/**
 * Small text helper shared by every summary that must stay bounded in size (outlines, node
 * summaries, the rendered-page excerpt): extracts are a fixed-size preview, never an unbounded
 * copy of user/plugin content. Pure PHP.
 */
final class Text
{
    /** Shortens to at most $max characters (multi-byte aware), appending an ellipsis. */
    public static function shorten(string $text, int $max): string
    {
        return mb_strlen($text) > $max ? rtrim(mb_substr($text, 0, $max - 1)) . '…' : $text;
    }
}