<?php

namespace Modules\EcommerceFinance\Http\Concerns;

use Modules\EcommerceFinance\Services\AccountLedgerRemarkMap;

/**
 * 店铺收款账户账单：给每行账单补「总账备注」（按平台 + 账单项目匹配映射表）。
 *
 * 只在读取时补齐，不改动上游账单与镜像数据。
 */
trait DecoratesLedgerRemarks
{
    protected function ledgerRemarkMap(): AccountLedgerRemarkMap
    {
        return app(AccountLedgerRemarkMap::class);
    }

    /**
     * 分页结果（含 data 行数组）补总账备注。
     *
     * @param  array<string,mixed>  $data
     * @return array<string,mixed>
     */
    protected function withLedgerRemarks(array $data, string $tab): array
    {
        if (! empty($data['data']) && is_array($data['data'])) {
            $map = $this->ledgerRemarkMap();
            $data['data'] = array_map(
                static fn (mixed $row): mixed => is_array($row) ? $map->decorate($row, $tab) : $row,
                $data['data'],
            );
        }

        return $data;
    }

    /**
     * 导出/流式行补总账备注。
     *
     * @param  iterable<int,array<string,mixed>>  $rows
     * @return iterable<int,array<string,mixed>>
     */
    protected function ledgerRemarkRows(iterable $rows, string $tab): iterable
    {
        return $this->ledgerRemarkMap()->decorateAll($rows, $tab);
    }
}