<?php

declare(strict_types=1);

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

namespace App\Tools\Entity;

/**
 * Tool 输出中 EntityReference 的向后兼容 JSON Schema 片段。
 */
final class EntityReferenceSchema
{
    /**
     * @return array<string, mixed>
     */
    public static function object(): array
    {
        return [
            'type' => 'object',
            'required' => ['entity_type', 'entity_id', 'label'],
            'additionalProperties' => false,
            'properties' => [
                'entity_type' => [
                    'type' => 'string',
                    'enum' => EntityType::values(),
                ],
                'entity_id' => [
                    'type' => 'integer',
                    'minimum' => 1,
                ],
                'label' => [
                    'type' => 'string',
                    'minLength' => 1,
                    'maxLength' => EntityReference::MAX_LABEL_LENGTH,
                ],
            ],
        ];
    }

    /**
     * @param  array<string, mixed>  $objectSchema
     * @return array<string, mixed>
     */
    public static function withRef(array $objectSchema): array
    {
        $objectSchema['properties']['entity_ref'] = self::object();

        return $objectSchema;
    }

    /**
     * @param  array<string, mixed>  $objectSchema
     * @return array<string, mixed>
     */
    public static function withRefs(array $objectSchema): array
    {
        $objectSchema['properties']['entity_refs'] = [
            'type' => 'array',
            'items' => self::object(),
        ];

        return $objectSchema;
    }

    /**
     * 订单/结算单据上的往来身份：保留原有 id/code/name，附加可选 entity_ref。
     *
     * @return array<string, mixed>
     */
    public static function nestedCounterparty(): array
    {
        return [
            'type' => 'object',
            'required' => ['name'],
            'additionalProperties' => false,
            'properties' => [
                'id' => ['type' => 'integer'],
                'code' => ['type' => 'string'],
                'name' => ['type' => 'string'],
                'entity_ref' => self::object(),
            ],
        ];
    }
}
