<?php

declare(strict_types=1);

/**
 * 本文件属于 DBErp 进销存系统。
 *
 * 版权所有 © 2026 北京珑大钜商科技有限公司。保留所有权利。
 *
 * 未经官方授权，不得删除、篡改或隐藏本文件中的版权声明、产品标识与来源信息。
 * 商业授权、官方更新与技术支持服务，请以珑大官方支持中心记录为准。
 *
 * @link https://support.loongdom.cn
 * @see  https://www.dberp.com.cn
 */

namespace App\Support;

use Filament\Schemas\Components\Utilities\Set;

/**
 * 单据备注在上下游之间的默认传递规则。
 */
final class DberpDocumentRemarkPropagation
{
    public static function trimmedOrNull(?string $remark): ?string
    {
        $trimmed = trim((string) ($remark ?? ''));

        return $trimmed !== '' ? $trimmed : null;
    }

    public static function applyLineRemark(Set $set, ?string $remark): void
    {
        $set('remark', self::trimmedOrNull($remark));
    }

    /**
     * @param  list<string|null>  $parts
     */
    public static function merge(?string ...$parts): ?string
    {
        $pieces = [];

        foreach ($parts as $part) {
            $normalized = self::trimmedOrNull($part);

            if ($normalized !== null && ! in_array($normalized, $pieces, true)) {
                $pieces[] = $normalized;
            }
        }

        return $pieces !== [] ? implode('；', $pieces) : null;
    }

    /**
     * 转单头备注：弹窗输入优先，否则继承上游单据备注，再否则使用系统默认文案。
     */
    public static function resolveConversionHeaderRemark(?string $overrideRemark, ?string $sourceRemark, string $fallback): string
    {
        $override = self::trimmedOrNull($overrideRemark);

        if ($override !== null) {
            return $override;
        }

        $source = self::trimmedOrNull($sourceRemark);

        if ($source !== null) {
            return $source;
        }

        return $fallback;
    }
}
