Uploads

<?php

namespace App\Control\Tutor;

use App\Support\Tutor\TutorPage;
use Mad\Form\MadForm;
use Mad\Http\MadResponse;
use Mad\Service\MadUploadIngest;

/**
 * TutorFormsUploads — página "Uploads" do catálogo (grupo forms).
 *
 * Cobre mad-file-field, mad-multi-file-field e mad-attach-btn com demos
 * vivas. mad-attachments fica documentado via callout na view — ele exige
 * model+foreign-key apontando pra um registro PAI já persistido (resolve o
 * id sozinho a partir da tela), o que não existe numa página de exemplos sem
 * estado como esta (ver relatório final do lote).
 *
 * Nível demo: nenhum arquivo é gravado em disco/banco. onUploadDemo() lê os
 * arquivos crus de $_FILES via MadUploadIngest::filesFor() (mesmo helper que
 * o framework usa internamente antes de gravar) só para exibir nome/tamanho
 * no toast — sem storage, sem form->save() num registro.
 */
class TutorFormsUploads extends TutorPage
{
    protected string $catalogKey = 'forms_uploads';

    public MadForm $form;

    public function mount(array $params = []): void
    {
        $this->form = new MadForm('tutor_forms_uploads');
    }

    public function onUploadDemo(): MadResponse
    {
        $unico = MadUploadIngest::filesFor('arquivo_unico_wire');
        $multi = MadUploadIngest::filesFor('anexos_wire');

        $partes = [];

        if ($unico !== []) {
            $f = $unico[0];
            $partes[] = "arquivo_unico_wire={$f['name']} (" . $this->formatBytes((int) $f['size']) . ')';
        }

        if ($multi !== []) {
            $total = array_sum(array_column($multi, 'size'));
            $partes[] = count($multi) . ' anexo(s) em anexos_wire, ' . $this->formatBytes((int) $total) . ' no total';
        }

        $resumo = $partes !== [] ? implode(' | ', $partes) : 'nenhum arquivo selecionado';

        return (new MadResponse())
            ->toast("Upload recebido: {$resumo}", 'success', 'onUploadDemo');
    }

    private function formatBytes(int $bytes): string
    {
        if ($bytes < 1024) {
            return "{$bytes} B";
        }
        if ($bytes < 1024 * 1024) {
            return round($bytes / 1024, 1) . ' KB';
        }

        return round($bytes / (1024 * 1024), 1) . ' MB';
    }
}

<x-tutor-page page="forms_uploads">
    <x-tutor-demo demo="tutor.examples.forms-uploads.arquivo-unico"
        title="Arquivo único" desc="mad-file-field: um arquivo por campo, storage disk ou db." />

    <x-tutor-demo demo="tutor.examples.forms-uploads.multiplos-arquivos"
        title="Múltiplos arquivos" desc="mad-multi-file-field: vários arquivos, mode=comma ou mode=table." />

    <x-tutor-demo demo="tutor.examples.forms-uploads.attach-btn"
        title="Botão compacto" desc="mad-attach-btn: mesma API de storage do multi-file, visual de paperclip pra toolbar." />

    <x-tutor-demo demo="tutor.examples.forms-uploads.wire-submit"
        title="Ação wire" desc="mad-form com submit real — dispara TutorFormsUploads::onUploadDemo, que lê os arquivos crus de $_FILES e mostra nome/tamanho no toast (sem persistir)."
        php="TutorFormsUploads::onUploadDemo" />

    <mad-callout type="warning" title="mad-attachments não dá pra demonstrar ao vivo aqui" icon="triangle-alert">
        mad-attachments exige <code>model</code> + <code>foreign-key</code> apontando pra um registro PAI que já
        existe no banco — ele resolve sozinho o id do registro a partir da tela atual e lista/envia/apaga anexos
        reais daquele registro. O MAD Lab é uma página de exemplos sem estado (sem registro persistido nem
        tabela de anexos própria), então demonstrar esse componente ao vivo exigiria sair do escopo de "showcase
        de campos" — precisaria de uma tabela filha nova (migration/model), um registro pai fixo e trait extra,
        o que não cabe no nível demo desta página (ver relatório do lote).
        <br><br>
        Sintaxe de referência (numa tela de detalhe real, com o registro já salvo):
        <br>
        <code>&lt;mad-attachments model="TicketAttachments" foreign-key="ticket_id" folder="uploads/tickets" /&gt;</code>
    </mad-callout>
</x-tutor-page>