CTNHCommandChatHelper.java

package tech.vixhentx.mcmod.ctnhlib.command;

import net.minecraft.ChatFormatting;
import net.minecraft.network.chat.ClickEvent;
import net.minecraft.network.chat.Component;
import net.minecraft.network.chat.HoverEvent;
import net.minecraft.network.chat.MutableComponent;
import net.minecraft.network.chat.Style;

import java.util.ArrayList;
import java.util.List;
import java.util.function.Function;

/**
 * 用于构建 /ctnh 检查命令的点击复制聊天行的辅助工具。
 * 每行输出的文本在点击时会复制对应值内容，并显示悬浮提示。
 */
public final class CTNHCommandChatHelper {

    /** 单个聊天行值的最大长度，超过该长度将拆分为多个块。 */
    public static final int MAX_VALUE_LINE_LENGTH = 256;

    private CTNHCommandChatHelper() {}

    /**
     * 为带标签的值构建一个或多个可点击的聊天行。长值将被拆分为
     * 额外的可复制续行，以避免聊天窗口静默丢弃内容。
     *
     * @param label 本地化标签
     * @param value 原始值字符串（不能为 null）
     * @return 一个或多个可发送的 {@link Component} 行
     */
    public static List<Component> labeledLines(Component label, String value) {
        return labeledLines(label, value, ChatFormatting.WHITE);
    }

    /**
     * 为带标签的值构建一个或多个可点击的聊天行，并用指定颜色显示值部分。
     * 长值将被拆分为额外的可复制续行，以避免聊天窗口静默丢弃内容。
     *
     * @param label      本地化标签
     * @param value      原始值字符串（不能为 null）
     * @param valueColor 值文本颜色
     * @return 一个或多个可发送的 {@link Component} 行
     */
    public static List<Component> labeledLines(Component label, String value, ChatFormatting valueColor) {
        return labeledLines(label, value, value, valueColor);
    }

    /**
     * 为带标签的值构建一个或多个可点击的聊天行，并允许显示值和复制值不同。
     */
    public static List<Component> labeledLines(Component label, String value, String copyText,
                                               ChatFormatting valueColor) {
        List<Component> lines = new ArrayList<>();
        String safe = value == null ? "" : value;
        String safeCopy = copyText == null ? safe : copyText;
        if (safe.length() <= MAX_VALUE_LINE_LENGTH) {
            lines.add(buildLine(label, safe, safeCopy, valueColor));
            return lines;
        }
        int total = safe.length();
        int chunkIndex = 0;
        for (int start = 0; start < total; start += MAX_VALUE_LINE_LENGTH) {
            int end = Math.min(total, start + MAX_VALUE_LINE_LENGTH);
            String chunk = safe.substring(start, end);
            if (chunkIndex == 0) {
                lines.add(buildLine(label.copy(), chunk, chunk, valueColor));
            } else {
                lines.add(buildContinuationLine(label, chunk, chunk, valueColor,
                        Component.translatable("command.ctnhlib.copy.hover")));
            }
            chunkIndex++;
        }
        // 尾部摘要行（不可复制，仅用于提示信息）。
        lines.add(Component.translatable("command.ctnhlib.value.truncated", total)
                .withStyle(ChatFormatting.GRAY));
        return lines;
    }

    /** 为多个标签 ID 构建逐行显示的可复制聊天行，每行点击时仅复制标签 ID。 */
    public static List<Component> labeledTagLines(Component label, List<String> tagIds, ChatFormatting tagColor) {
        return labeledTagLines(label, tagIds, tagColor,
                ignored -> Component.translatable("command.ctnhlib.copy.hover"));
    }

    /** 为多个标签 ID 构建逐行显示的可复制聊天行，并允许每行使用自定义悬浮提示。 */
    public static List<Component> labeledTagLines(Component label,
                                                  List<String> tagIds,
                                                  ChatFormatting tagColor,
                                                  Function<String, Component> hoverFactory) {
        List<Component> lines = new ArrayList<>();
        if (tagIds == null || tagIds.isEmpty()) {
            lines.addAll(labeledLines(label,
                    Component.translatable("command.ctnhlib.value.empty").getString(),
                    tagColor));
            return lines;
        }
        for (int i = 0; i < tagIds.size(); i++) {
            String tagId = tagIds.get(i);
            String safe = tagId == null ? "" : tagId;
            Component hover = hoverFactory == null ? Component.translatable("command.ctnhlib.copy.hover") :
                    hoverFactory.apply(safe);
            if (i == 0) {
                lines.add(buildLine(label.copy(), safe, safe, tagColor, hover));
            } else {
                lines.add(buildContinuationLine(label, safe, safe, tagColor, hover));
            }
        }
        return lines;
    }

    /**
     * 构建单个聊天行，其可见文本为 "label: value"，单击事件将逐字复制提供的 {@code copyText}。
     */
    public static Component buildLine(Component label, String value, String copyText) {
        return buildLine(label, value, copyText, ChatFormatting.WHITE);
    }

    /**
     * 构建单个聊天行，其可见文本为 "label: value"，单击事件将逐字复制提供的 {@code copyText}。
     */
    public static Component buildLine(Component label, String value, String copyText, ChatFormatting valueColor) {
        return buildLine(label, value, copyText, valueColor, Component.translatable("command.ctnhlib.copy.hover"));
    }

    /**
     * 构建单个聊天行，其可见文本为 "label: value"，并使用自定义悬浮提示。
     */
    public static Component buildLine(Component label,
                                      String value,
                                      String copyText,
                                      ChatFormatting valueColor,
                                      Component hoverText) {
        MutableComponent labelStyled = label.copy().withStyle(ChatFormatting.AQUA);
        MutableComponent valueStyled = Component.literal(value).withStyle(valueColor);
        MutableComponent line = Component.empty()
                .append(labelStyled)
                .append(Component.literal(": ").withStyle(ChatFormatting.GRAY))
                .append(valueStyled);

        Style style = Style.EMPTY
                .withClickEvent(new ClickEvent(ClickEvent.Action.COPY_TO_CLIPBOARD, copyText))
                .withHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, hoverText));
        return line.withStyle(style);
    }

    /**
     * 构建续行（无标签和冒号），仅显示与首行值列对齐的值部分。
     * 使用空格填充来匹配首行 "label: " 的宽度，然后仅追加带颜色的值。
     */
    private static Component buildContinuationLine(Component label, String value, String copyText,
                                                   ChatFormatting valueColor, Component hoverText) {
        int pad = label.getString().length() + 2; // "label: "
        MutableComponent spacer = Component.literal(" ".repeat(Math.max(0, pad)));
        MutableComponent valueStyled = Component.literal(value).withStyle(valueColor);
        MutableComponent line = Component.empty().append(spacer).append(valueStyled);

        Style style = Style.EMPTY
                .withClickEvent(new ClickEvent(ClickEvent.Action.COPY_TO_CLIPBOARD, copyText))
                .withHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, hoverText));
        return line.withStyle(style);
    }

    /** 分区标题行（无复制点击事件）。 */
    public static Component heading(Component component) {
        return component.copy().withStyle(ChatFormatting.GOLD);
    }

    /** 简单的信息提示行，例如"未包含流体"，无复制事件。 */
    public static Component info(Component component) {
        return component.copy().withStyle(ChatFormatting.GRAY);
    }

    /** 命令失败时使用的红色错误行。 */
    public static Component error(Component component) {
        return component.copy().withStyle(ChatFormatting.RED);
    }

    /**
     * 构建单个点击复制聊天行，其可见文本为提供的
     * {@code visible} 组件（无自动标签前缀），点击事件将复制提供的 {@code copyText}。
     */
    public static Component clickableLine(MutableComponent visible, String copyText) {
        return clickableLine(visible, copyText, Component.translatable("command.ctnhlib.copy.hover"));
    }

    /** 使用自定义悬浮提示构建无标签点击复制聊天行。 */
    public static Component clickableLine(MutableComponent visible, String copyText, Component hoverText) {
        Style style = Style.EMPTY
                .withClickEvent(new ClickEvent(ClickEvent.Action.COPY_TO_CLIPBOARD, copyText))
                .withHoverEvent(new HoverEvent(HoverEvent.Action.SHOW_TEXT, hoverText));
        return visible.withStyle(style);
    }
}